MelPump · Learn your app
App user manual
Connect your heat pump, understand its data and use MelPump to manage comfort, energy and everyday operation.
Current as of November 2026 · Last reviewed:
Read this before you start
This manual describes tasks rather than button positions. Names and layout may change. Available pages, readings and controls depend on your heat pump, integration, configuration, access rights and subscription. Air conditioners have their own dashboard and controls; heating zones, hot water and heat-pump automations do not apply to every device.
Chapter 01
Your first connection
Begin with an account and one integration. An integration is the connection that lets MelPump discover your devices and exchange data with them.
Where to find it: Sign up, then Add New Integration. Existing connections are in Account Settings → Integrations.
Create and activate your account
Use an email address you can access. You will use it for account recovery, invitations and email notifications.
- Register with your name, email and password, and accept the terms.
- If activation is requested, open the verification email and follow its link. Use the resend option if needed.
- Sign in. If you forget your password, use password recovery and follow the emailed link. Setting a new password signs you out on your other devices.
Add an integration and discover devices
Select the provider that matches your existing connection. MELCloud, MELCloud HOME, Planet Devices and the MelPump WiFi adapter use different credentials. MELCloud HOME is a beta integration with limited data and controls. Other providers may be available only on eligible accounts.
- Choose a provider and give the connection a recognizable name.
- Enter the details requested by that provider. For the WiFi adapter, complete the adapter setup and enter its serial number (letters and digits only); for a cloud provider, use the requested login or token.
- Review the connection and finish setup. Discovered devices appear in the device list.
- Select your device, check that readings arrive and review its configuration, especially location, time zone and enabled zones.
Already connected but unable to see an active device? Check existing integrations and inactive devices before adding the same connection again.
Chapter 02
Check your system each day
The dashboard brings together current operation and recent history. Always check which device and period you are viewing before interpreting a number.
Where to find it: Select a device → Dashboard. Heat-pump dashboards have Overview, Manage and Details views.
Current state is only as fresh as its last update
Check the connection status and last update first. A heat pump is marked offline when its telemetry is more than ten minutes old. The app can still display its last known readings, so visible temperatures are not proof of a live connection. Switching to another dashboard view does not make old data fresh.
A useful daily routine
Overview helps you spot trends, Manage brings together controls and today's plan, and Details exposes the readings supported by your device.
- Check temperatures, operating mode and any connection or device notices.
- Review the temperature and operation charts, energy history and weather. Change the selected period when comparing days.
- In Manage, check today's planned actions and recent activity before changing settings. Use Details when you need more telemetry.
A missing reading can mean that the integration does not provide it. Compare similar periods and conditions rather than judging the system from one snapshot.
Chapter 03
Change comfort and operating settings
MelPump exposes the commands your device supports, such as power, zone temperatures and hot-water operation. Read-only access lets you monitor a device but does not let you change it.
Where to find it: Dashboard → Manage for quick actions; Device Settings for operating modes; Configuration for installation details.
Make one change and confirm its effect
Depending on the device, you can permit or block heating, cooling or hot water, change temperature targets, or request Force Hot Water. A hot-water boost heats the tank now; it does not replace your normal heating plan. Cooling and a second zone appear only when supported and configured.
- Select the correct device and zone. Check whether an automation is currently controlling the setting.
- Choose the supported operating mode or temperature target. Room temperature and flow temperature control different things.
- Save or apply the change when the page asks for it.
- Wait for the pump to confirm its new state, then check the readings. Confirmation time depends on the integration; an immediate UI change is not confirmation of the physical result.
Keep installation details accurate
Configuration describes the installation, including location, time zone, zones and displayed sensors. These choices affect forecasts, schedules and the information shown in reports. Match them to the actual system; exposing a zone in the app does not install or enable that zone in the heat pump. Configuration also holds the temperatures of the quick preset buttons under the tank water and indoor temperature sliders; clear a value to return to its default. The same card has Show thermostat setpoint options that hide the indoor temperature slider of a zone in the device controls; reports and automations are not affected.
If supported App Control Mode is enabled, it can stop the pump controller's own schedules until disabled. Read its explanation before changing how the installation is controlled.
Chapter 04
Understand charts and reports
Use reports to answer a specific question about temperatures, consumption or operation. The available history and metrics depend on the data supplied by the integration.
Where to find it: Temperature Report, Energy Report and Detailed Report for the selected device. Installers can open Live Report from their fleet's device list.
Choose the right report
Temperature Report shows a selected day or a date range with available sensors. Energy Report compares consumed and produced energy across days, months or years. Detailed Report combines recorded parameters for investigating events. Live Report collects readings and changes while you observe the system; refreshing its chart does not increase the device's telemetry frequency.
Compare like with like
COP compares produced heat with consumed electricity. A period's COP is based on its energy totals. Weather, hot-water demand and operating mode can change those totals, and some integrations provide incomplete or estimated energy data.
- Select the device, date or range, and the sensors or series relevant to your question.
- Compare temperatures and operating modes alongside energy. Check data gaps before drawing conclusions.
- Use Export where available to download data for further analysis. On a newly connected device, allow up to 24 hours for the first energy totals.
Use an external energy meter
Configuration → Energy meter connects a meter that measures only the heat pump. MelPump uses its readings as the heat pump's input power and as the daily consumption everywhere in the app, including Energy Report, the dashboard and shared reports. The values reported by the heat pump are kept aside, and days without a meter reading still show them. Turning Measured consumption off makes the following days use the reported values again, while days already measured keep the meter readings. Home Assistant or another system can also send a whole-day total for each day through the API.
- Open Configuration, choose Energy meter and select Connect Shelly. Share the meter in Shelly and wait until it appears with its channels.
- When you connect a meter that is not in MelPump yet from the Energy meter tab of this heat pump, its channels are switched on for it as soon as its first readings arrive, provided that happens within 24 hours; if the meter has an All phases channel, only that one. Switch off the channels that measure other circuits. To measure the individual phases instead, switch them on, which turns All phases off.
- After a few minutes, check that each switched-on channel shows its current power. Measured today and daily totals start with the first full day after the meter was connected.
A report link grants access to that report, while device sharing grants ongoing access to the device. Choose the form of sharing that fits the task.
Chapter 05
Plan recurring actions
A schedule is a weekly plan of actions at selected times. Use it for predictable routines, such as changing zone targets or hot-water operation.
Where to find it: Selected device → Schedule, including switching schedules on and off, Run History and Info & tools.
Create and switch on weekly schedules
You can keep up to four named schedules and switch each one on or off. Every schedule that is on runs its actions, so two schedules can run together, for example one for heating and one for hot water. Creating or importing a schedule switches it on. Avoid actions in different schedules that change the same setting at the same time. Available actions depend on the device's controls.
- Create a named profile for a routine you recognize, such as a normal week or time away.
- Add the days, times and supported actions. Every day, Weekdays and Weekend save one action for all of those days, so a later edit or removal changes them together. Check the device's time zone.
- Save the actions and check that the schedule is switched on.
- Check Run History after an action is due. Review what ran before changing the plan.
Save, test and restore a profile
In Info & tools, Export JSON saves a profile's name, season and timed actions as a JSON file with descriptive keys. Keep a copy before experimenting, compare versions or let an AI assistant review and edit the file. Show instructions lists the action keys and values this device accepts, and Copy AI prompt copies them as English instructions for an AI assistant such as ChatGPT; paste them, then add your file and what you want to change. Import from JSON file adds the file as a new schedule and switches it on at once, next to the schedules that are already on; a device holds up to four schedules. To go back, switch the imported schedule off and the original one on. Importing needs write access. Imported actions are not checked against the device's controls, so review the Weekly grid afterwards.
When an action does not happen as expected
App schedules need a stable internet connection. Avoid overlapping plans in MelPump and the pump controller. Summer ECO can keep the pump off, and a scheduled temperature or zone change to a setting an active automation has changed waits until that automation finishes; other scheduled changes apply right away. Check which schedules are on and which automation is active before repeating an action manually.
A scheduled time describes the plan. Run History and the device's confirmed state tell you what actually happened.
Chapter 06
Use automatic optimization
Start with comfortable base settings, then enable the supported automation that matches your goal. Read the explanation in each mode and observe its effect before adjusting more settings.
Where to find it: Device Settings → Manage, Smart Energy, Solar Panel, Night Mode or Summer ECO, when available.
Online Curve and weather-based heating
Online Curve lets MelPump adjust flow temperature against outdoor temperature for a selected zone. It is different from the manufacturer's heating curve. Choose Online Curve, edit its points and corrections, then Apply; drafts do not take effect until applied. Monitor comfort and temperatures afterward. Offline behavior differs by connection: a cloud-controlled device keeps its last flow target, while a compatible WiFi adapter can continue the stored curve locally.
Smart Energy and electricity prices
Select the correct country and price region, review the price chart and choose a preset or your own strategy. Configure what may change during expensive and cheap periods. With your own strategy you can also limit how often cheap and expensive periods may start: within the chosen time each mode switches on and off at most once, so the heat pump does not change modes every 15 minutes, while a single price spike can still get its own short period. Then save and enable the mode. Smart Energy temporarily changes supported settings and restores preferred settings afterward. Check that the price region and your electricity contract fit the strategy; market prices are not necessarily your final bill.
Solar Mode and forecast production
Set the device location and describe your PV installation, including power and orientation. Choose whether to boost hot water or a supported zone, set targets and operating windows, and save. Solar Mode chooses periods from a solar/weather forecast. This is not a measurement of your home's live surplus or a guarantee that the pump will use only solar electricity.
Night Mode and Summer ECO
Night Mode sets lower zone temperatures during chosen hours every day and sets the daytime temperature again when the night ends. This is the temperature that was set just before the night started. Night Mode runs as a schedule: it appears in Schedule and Run History, but you change it only in Device Settings → Night Mode. It does not guarantee quieter operation. Where supported, Summer ECO focuses on hot water in warm months, with its own reheating conditions and optional time window. Check those settings if the pump stays off outside the window.
The Controlled by banner identifies an active automation. Check it when a target changes unexpectedly, and review overlapping modes and schedules together.
Chapter 07
Set alerts and review events
Alarm rules belong to your account and apply to the selected device. Even a shared read-only user can manage their own alarm rules.
Where to find it: Selected device → Notifications → Alarm Rules and History.
Create a useful alarm rule
Choose a reading the device actually supplies and a condition that indicates a problem you want to know about. Avoid thresholds that normal operation repeatedly crosses.
- Select the metric and configure its condition or threshold.
- Choose email, push or the available combination, and check the email recipients.
- For browser push, grant notification permission when requested. In the mobile app, also check the app's system notification permissions.
- Save the rule and use History to review triggered alarms.
An alert is a starting point for investigation
Read the alarm's time, value and threshold, then inspect the device's current state and the matching report period. Acknowledge the event after reviewing it. Acknowledging an alarm organizes history; it does not repair the heat pump or change the rule.
If notifications are missing, check the rule, channel, recipients and device permissions before creating duplicate rules.
Chapter 09
Manage your account and connections
Account Settings covers your profile, display preferences and integrations. Device settings cover the selected installation.
Where to find it: Account Settings → Profile, Integrations and API & apps (API tokens and connected AI apps). Additional tabs appear when relevant.
Profile and preferences
Adjust your display name, language and available theme or chart preferences here. Default dashboard period sets the range the device Overview shows when you open it (Yesterday unless changed). Use the password-change action to request a recovery email. Email changes depend on account eligibility; use support if direct editing is unavailable. Account deletion schedules removal and immediately signs you out, so read the confirmation before proceeding.
Maintain an existing integration
Use the integration's connection details to update supported credentials. Refresh updates the integration's device list and reactivates an inactive connection once the provider returns its devices. For a Panasonic Service Cloud connection requested through an owner invitation, Refresh also verifies the required access and current device readings first. If these checks fail, Refresh reports an error and the connection stays inactive. With a Service Cloud installer account, Refresh signs in again and adds heat pumps newly shared with the account. Deactivating a device stops telemetry collection but keeps its history; removing a connection is a different action.
- Find the existing integration and check whether it and its devices are active.
- Open Connection details and update the fields supported by that provider, then check that communication resumes.
- If you change the MQTT password, reconfigure every adapter using that connection. The password change in the app does not update the adapters automatically.
API tokens for your own integrations
API Tokens lets you manage credentials for tools that use the MelPump API. Keep tokens private and revoke unused ones. Follow the API documentation for supported requests; creating a token does not add a heat-pump provider or expand the device's capabilities.
Connected AI apps
Connected apps lets AI assistants such as Claude or ChatGPT read your heat pump data for analysis. Add the server address shown there as a custom connector in the assistant, sign in when asked and read the consent screen: it names the app, shows where it sends you back and grants read-only access only. Connected apps cannot change settings, control devices or acknowledge alarms. Apps marked as unverified need extra care, so continue only if you started the connection yourself. Removing an app ends its access immediately.
Repair the existing connection before creating another one for the same devices. Read removal confirmations carefully so you do not confuse deactivation with deletion.
Chapter 10
Check access and subscriptions
Subscription validity is associated with a device. Trial terms, available plans and prices can change; use the current information displayed in the app.
Where to find it: Subscriptions, including the subscription page for a selected device.
Choose a device and its plan
The owner manages paid access. A shared user can ask the owner to renew rather than purchasing through the owner's account.
- Select the correct device and check its displayed status and validity date.
- When renewal or purchase is available, review the offered plan, term and total price.
- Complete payment and verify the updated validity in the app. Payment receipts are sent by email.
Manage an auto-renewing subscription
Some plans renew automatically at the end of each period. For such a device, the subscription page shows the next payment date instead of a new purchase. Use Manage subscription to change the payment card or cancel the renewal; the device stays active until the end of the period already paid for. If a renewal payment fails, the app shows a warning on the dashboard; update the payment method to keep the device active.
Request a subscription change
Use Ask for change for requests such as a different term, transfer, cancellation or refund. The request opens a support ticket that already includes the device and subscription details. Follow it and reply in Contact; the change is not applied immediately. Billing history is not yet a usable transaction archive in this edition, so keep your emailed receipts. Auto-renewing subscriptions are cancelled with Manage subscription, not through a change request.
Check the selected device and owner before paying or requesting changes. The app's displayed offer takes precedence over prices mentioned in older material.
Chapter 11
Solve common problems and get help
Begin with connection freshness, device selection and active automations. These checks explain many cases of stale data, missing controls or unexpected targets.
Where to find it: Dashboard notices, Account Settings → Integrations, and Contact / your support conversations.
The device is offline or readings stopped
Check the last update, the heat pump or adapter's internet connection, and whether the integration and device are active. For cloud connections, check your provider credentials or authorization. For the WiFi adapter, check its setup and connection details. Reconnect the existing integration when possible. An app page opening successfully does not prove the pump is online.
A control is missing or a change does not stick
Confirm that you selected the right device, have Write access and have valid device access. Check supported capabilities and configuration; MELCloud HOME beta and air conditioners expose a different set of features. If a target changes back, inspect Controlled by, today's plan and Run History. If energy totals are empty after connecting, allow the first day of collection before treating it as a fault.
Send a report that can be investigated
Contact lets you choose a topic, describe the issue and attach files. When you send a request under Other support, Bug report or Account & login, matching FAQ answers may appear first. If one solves the problem, confirm it and nothing is sent; otherwise send your message anyway. Other support also suggests asking the Facebook community for advice from owners and installers on heat pump settings and interpreting your results. We usually reply within 5 business days. While your message is waiting for a reply, edit it instead of sending another one. After our reply you can respond in the same conversation or close it; a conversation with no new message for 14 days closes automatically and can no longer be continued, so start a new request for a new problem. Subscription requests use their dedicated change-request flow; help with heat pump optimization directs you to the community.
- State the device, integration, event time and time zone, what you expected and what happened.
- Add relevant readings, screenshots, an exported report or a deliberately shared report link. Do not attach passwords or API tokens.
- Send the request and follow its replies in your support conversations.
For concepts such as flow temperature, COP or compressor operation, use the Heat Pump Guide linked from this manual.
This edition was checked against the application in November 2026. When a documented feature changes, its instructions and review date should be updated together. For later releases, also check the changelog and the explanations inside the app.
See what changed in MelPump →