Heroku

The Heroku Platform MCP Server enables large language models to read, manage, and operate Heroku Platform resources through a secure, authenticated MCP interface. It provides practical tools for interacting with Heroku resources via natural language workflows while leveraging your existing Heroku CLI authentication.

How to use

You connect an MCP client to the Heroku MCP Server to perform actions such as listing apps, managing dynos, viewing logs, and handling add-ons through natural language prompts. Start the server using your preferred method, then configure your client to forward requests to the MCP server. The server authenticates via your Heroku CLI session or via an API key if you choose to run it with npx.

How to install

Prerequisites include having Node.js and npm installed on your system, as well as the Heroku CLI installed globally at version 10.8.1 or higher.

{
  "mcpServers": {
    "heroku": {
      "command": "heroku mcp:start"
    }
  }
}

Additional content

You can configure multiple MCP clients to work with the Heroku MCP Server. The following configurations demonstrate two common approaches: running directly via the Heroku CLI, or launching the MCP server through npx with an API key for authentication.

{
  "mcpServers": {
    "heroku": {
      "command": "heroku mcp:start"
    }
  }
}

Environment and startup notes

When using the Heroku CLI method, the server authenticates using your current Heroku CLI session, so you do not need to set a separate API key. If you prefer to run with an API key, you can use the npx based method shown in the following configuration examples.

Troubleshooting and debugging

If you encounter authentication issues, ensure your Heroku CLI is logged in and that your session is active. For local development, you can attach a debugger to inspect the MCP server and verify that it reaches the intended Heroku resources.

Security considerations

Protect your credentials. When using API keys, store them securely and avoid embedding them in shared configurations. Leverage your existing Heroku CLI authentication whenever possible to minimize secret management.

Available tools

list_apps

List all Heroku apps, with filters for personal apps, collaborators, teams, or spaces.

get_app_info

Retrieve detailed information about an app, including 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 app ownership to another user or team.

deploy_to_heroku

Deploy projects to Heroku with an app.json configuration, including team deployments and environments.

deploy_one_off_dyno

Run a one-off dyno for ad-hoc scripts, tests, or temporary workloads with optional environment and file handling.

ps_list

List all dynos for a given app.

ps_scale

Scale the number of dynos or resize dynos for an app.

ps_restart

Restart specific dynos, process types, or all dynos.

list_addons

List add-ons for all apps or 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 for debugging and monitoring.

pipelines_create

Create a new deployment pipeline.

pipelines_promote

Promote apps to the next stage in a pipeline.

pipelines_list

List available pipelines.

pipelines_info

Get detailed information about a pipeline.

list_teams

List teams you belong to.

list_private_spaces

List available private 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.