# Heroku MCP Server [Official] [Health: Active]

**Category:** ☁️ Cloud Platforms  
**Repository:** https://github.com/heroku/heroku-mcp-server  
**GitHub Stars:** 82  
**npm Downloads (last month):** 34120  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/heroku-mcp-server

## Description
Heroku's official Platform MCP server. Lets AI agents read, manage and operate Heroku apps, dynos, add-ons, pipelines and Postgres databases through the Heroku CLI. Start it with heroku mcp:start (uses your CLI login) or npx -y @heroku/mcp-server with a HEROKU_API_KEY.

## Tools
Capabilities this server exposes over MCP:

- **list_apps** — List all Heroku apps. You can filter apps by personal, collaborator, team, or space.
- **get_app_info** — Get detailed information about an app, including its configuration, dynos, and add-ons.
- **create_app** — Create a new app with customizable settings for region, team, and space.
- **rename_app** — Rename an existing app.
- **transfer_app** — Transfer ownership of an app to another user or team.
- **deploy_to_heroku** — Deploy projects to Heroku with an `app.json` configuration, supporting team deployments, private
- **deploy_one_off_dyno** — Execute code or commands in a sandboxed environment on a Heroku one-off dyno. Supports file
- **ps_list** — List all dynos for an app.
- **ps_scale** — Scale the number of dynos up or down, or resize dynos.
- **ps_restart** — Restart specific dynos, process types, or all dynos.
- **list_addons** — List all add-ons for all apps or for a specific app.
- **get_addon_info** — Get detailed information 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** — View application logs.
- **pipelines_create** — Create a new pipeline.
- **pipelines_promote** — Promote apps to the next stage in a pipeline.
- **pipelines_list** — List available pipelines.
- **pipelines_info** — Get detailed pipeline information.
- **list_teams** — List teams you belong to.
- **list_private_spaces** — List available spaces.
- **pg_psql** — Execute SQL queries against the Heroku PostgreSQL database.
- **pg_info** — Display detailed database information.
- **pg_ps** — View active queries and execution details.
- **pg_locks** — View database locks and identify blocking transactions.
- **pg_outliers** — Identify resource-intensive queries.
- **pg_credentials** — Manage database credentials and access.
- **pg_kill** — Terminate specific database processes.
- **pg_maintenance** — Show database maintenance information.
- **pg_backups** — Manage database backups and schedules.
- **pg_upgrade** — Upgrade PostgreSQL to a newer version.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

**Requires environment variables:** `HEROKU_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What Heroku MCP Server does

Heroku MCP Server exposes Heroku Platform operations as Model Context Protocol tools. Agents can inspect applications and their configuration, create or rename apps, transfer ownership, deploy projects, and run temporary commands on one-off dynos. Application operations can be filtered or scoped by personal ownership, collaborators, teams, regions, and spaces where the relevant tool supports those settings.

The server also covers day-to-day runtime management. It can list dynos, change dyno counts or sizes, restart individual dynos or process types, toggle maintenance mode, and retrieve application logs. Add-on tools list services across apps, inspect a specific add-on, and provision a new one.

Pipeline and database operations are included as well. Agents can create, inspect, list, and promote pipelines. Heroku Postgres tools execute SQL, show database details, inspect active queries and locks, identify expensive queries, manage credentials, terminate database processes, and display maintenance information.

## How it works

The server runs as a local MCP process and exposes Heroku operations to compatible clients. The recommended launch path is `heroku mcp:start`, which uses the authentication already established in the local Heroku CLI session. This avoids putting an API token in the MCP client configuration.

An alternative launch path uses `npx -y @heroku/mcp-server`. That mode authenticates with the `HEROKU_API_KEY` environment variable, which should contain a Heroku authorization token. The token can be created with the Heroku CLI or through Heroku account settings.

## Setup and configuration

Install the Heroku CLI globally before running the server; the documented minimum is version 10.8.1. Check the installed version with `heroku --version`.

For CLI-based authentication, configure the client to run:

```sh
heroku mcp:start
```

For token-based authentication, configure the client to run `npx -y @heroku/mcp-server` and provide `HEROKU_API_KEY` in the server environment. The repository includes configurations for Claude Desktop, Zed, Cursor, Windsurf, Cline, and VS Code. A Heroku deployment option is also available from the project repository.

## Tools and capabilities

The tools are grouped around these operational areas:

- App management: list, inspect, create, rename, transfer, and deploy applications.
- Temporary execution: run commands or code in a sandboxed one-off dyno, with file creation, network access, environment variables, and automatic cleanup.
- Dynos: list, scale, resize, and restart processes.
- Add-ons: list, inspect, and provision add-ons.
- Operations: enable or disable maintenance mode and retrieve logs.
- Pipelines: create, list, inspect, and promote pipeline applications.
- PostgreSQL: run SQL and inspect queries, locks, outliers, credentials, processes, and maintenance state.

## Limitations and notes

The available tool set is in early development and may change as the project evolves. Access depends on the Heroku identity used by the CLI session or API token. The CLI requirement applies to the documented setup, including the `heroku mcp:start` command and the minimum supported CLI version. Deployments can use `app.json` configuration and support team deployments, private spaces, and environment setups.

_Full upstream README: https://allmcps.com/mcp/heroku-mcp-server/readme_