Heroku MCP server
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
{
"mcpServers": {
"heroku": {
"command": "npx",
"args": [
"-y",
"@heroku/mcp-server"
],
"env": {
"HEROKU_API_KEY": "<HEROKU_API_KEY>"
}
}
}
}claude mcp add heroku -- npx -y @heroku/mcp-serverAvailable 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.