The MCP server is open source (Apache-2.0) and free. It manages your Heroku account, so you pay only for the Heroku dynos, add-ons, and databases it provisions or runs.

Does it support remote/OAuth?

The package runs locally over stdio. Two auth paths exist: `npx -y @heroku/mcp-server` with a HEROKU_API_KEY environment variable, or `heroku mcp:start` (Heroku CLI 10.8.1+), which reuses your existing CLI login so no API key is required. There is no separate hosted OAuth endpoint in this configuration.

Heroku MCP server

OfficialHeroku (Salesforce)Config last verified Jun 1, 2026

Heroku's official Platform MCP server: deploy apps, scale dynos, manage add-ons and pipelines, run one-off commands, and operate Postgres from your agent.

Heroku is the platform-as-a-service that turns a git push into a running app, handling build, deploy, scaling, and managed add-ons for you. The official Heroku Platform MCP Server wraps the Heroku CLI so an agent can operate your account end to end — provision and deploy apps, scale and restart dynos, attach add-ons, promote through pipelines, and inspect or query Heroku Postgres — without leaving the conversation.

The server exposes a comprehensive tool set. App lifecycle: list_apps, get_app_info, create_app, rename_app, transfer_app, deploy_to_heroku (deploy via an app.json), and deploy_one_off_dyno (run a sandboxed command on a temporary dyno). Process management: ps_list, ps_scale, and ps_restart. Add-ons: list_addons, get_addon_info, and create_addon. Maintenance and logs: maintenance_on, maintenance_off, and get_app_logs. Pipelines: pipelines_create, pipelines_promote, pipelines_list, and pipelines_info. Teams and spaces: list_teams and list_private_spaces. Heroku Postgres: pg_psql, pg_info, pg_ps, pg_locks, pg_outliers, pg_credentials, pg_kill, pg_maintenance, pg_backups, and pg_upgrade. It runs over stdio with npx -y @heroku/mcp-server and authenticates with a HEROKU_API_KEY; alternatively, the bundled `heroku mcp:start` command (Heroku CLI 10.8.1+) reuses your existing CLI session so no API key is needed.

Quick install

Copy-paste configs are provided for all 8 supported clients. Pick your client below.

Add to ~/.claude.json

~/.claude.json

json

{
  "mcpServers": {
    "heroku": {
      "command": "npx",
      "args": [
        "-y",
        "@heroku/mcp-server"
      ],
      "env": {
        "HEROKU_API_KEY": "<HEROKU_API_KEY>"
      }
    }
  }
}

Or via CLI

bash

claude mcp add heroku -- npx -y @heroku/mcp-server

Step-by-step guides

Available tools

Tool	Description
list_apps	List all Heroku apps, with options to filter by team or personal account.
get_app_info	Retrieve comprehensive details about an app, including config, dynos, and add-ons.
create_app	Provision a new Heroku app with optional region, team, and stack settings.
rename_app	Change an app's name.
transfer_app	Transfer ownership of an app to another user or team.
deploy_to_heroku	Deploy a project to Heroku using its app.json configuration.
deploy_one_off_dyno	Run a command in a sandboxed one-off dyno.
ps_list	List the running dynos for an app.
ps_scale	Scale the number of dynos or resize a process type.
ps_restart	Restart an app's dynos or a specific process type.
list_addons	List add-ons across apps.
get_addon_info	Get details about a specific add-on.
create_addon	Provision a new add-on for an app.
maintenance_on	Enable maintenance mode for an app.
maintenance_off	Disable maintenance mode for an app.
get_app_logs	Retrieve an app's logs.
pipelines_create	Create a new pipeline.
pipelines_promote	Promote apps through pipeline stages.
pipelines_list	List all pipelines.
pipelines_info	Get details about a pipeline.
list_teams	List the teams the account belongs to.
list_private_spaces	List the available Private Spaces.
pg_psql	Run a SQL query against a Heroku Postgres database via psql.
pg_info	Show details about a Heroku Postgres database.
pg_ps	View active queries on a Heroku Postgres database.
pg_locks	Identify blocking transactions and locks on a database.
pg_outliers	Find the most resource-intensive queries on a database.
pg_credentials	Manage database credentials and access.
pg_kill	Terminate a database process.
pg_maintenance	Show maintenance information for a database.
pg_backups	Manage database backups and schedules.
pg_upgrade	Upgrade the PostgreSQL version of a database.

Required configuration

HEROKU_API_KEYRequired
Heroku authorization token. Required for the npx server; not needed with `heroku mcp:start`.

What you can do with it

Deploy and scale an app on request

Ask the agent to create an app, deploy it with deploy_to_heroku, then scale it: create_app provisions the app, the deploy tool ships it, and ps_scale sets the dyno formation — all from the conversation, reusing your Heroku CLI session.

Operate Heroku Postgres

Use pg_info and pg_ps to inspect a database, pg_outliers and pg_locks to chase down a slowdown, pg_psql to run an ad-hoc query, and pg_backups to confirm a snapshot before a risky change.

FAQ

Is it free?: The MCP server is open source (Apache-2.0) and free. It manages your Heroku account, so you pay only for the Heroku dynos, add-ons, and databases it provisions or runs.
Does it support remote/OAuth?: The package runs locally over stdio. Two auth paths exist: `npx -y @heroku/mcp-server` with a HEROKU_API_KEY environment variable, or `heroku mcp:start` (Heroku CLI 10.8.1+), which reuses your existing CLI login so no API key is required. There is no separate hosted OAuth endpoint in this configuration.

← Browse all cloud-infra servers