Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Cloud and hosting - official Heroku server

Heroku Platform MCP server

Open-source local MCP server that drives the Heroku CLI so agents can manage apps, dynos, add-ons, pipelines, logs and Heroku Postgres. Runs via heroku mcp:start or the @heroku/mcp-server npm package. It runs locally from @heroku/mcp-server (npm) with API key auth.

Last verified 15 tools5 sources

Install

Cursor

About Cursor
JSON
{
  "mcpServers": {
    "heroku": {
      "command": "heroku mcp:start"
    }
  }
}

VS Code

JSON
{
  "mcp": {
    "servers": {
      "heroku": {
        "type": "stdio",
        "command": "heroku",
        "args": ["mcp:start"]
      }
    }
  }
}

Generic

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

Tools

list_apps
List all Heroku apps, filterable 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 settings for region, team, and space.
deploy_to_heroku
Deploy projects to Heroku with an app.json configuration.
deploy_one_off_dyno
Execute code or commands in a sandboxed one-off dyno with automatic cleanup.
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.
create_addon
Provision a new add-on for an app.
get_app_logs
View application logs.
maintenance_on
Enable maintenance mode for an app.
pipelines_promote
Promote apps to the next stage in a pipeline.
pg_psql
Execute SQL queries against the Heroku PostgreSQL database.
pg_backups
Manage database backups and schedules.

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Heroku describes it as "currently in early development" (mapped to preview).
  • Requires Heroku CLI v10.8.1+ installed globally.
  • Auth: heroku mcp:start reuses the Heroku CLI session (recommended); the npx method requires HEROKU_API_KEY.
  • Works on Common Runtime, Cedar Private and Shield Spaces, and Fir Private Spaces.
  • Latest release mcp-server-v1.2.12 (npm 1.2.12).
  • Heroku now positions the Remote MCP Server as the centrally managed alternative.
  • Full tool list has ~35 tools; 15 shown.

More MCP servers for cloud and hosting

Related reading

FAQ

What does the Heroku Platform MCP server do?

Open-source local MCP server that drives the Heroku CLI so agents can manage apps, dynos, add-ons, pipelines, logs and Heroku Postgres. Runs via heroku mcp:start or the @heroku/mcp-server npm package. The vendor documents 15 tools, including list_apps, get_app_info, create_app and deploy_to_heroku.

How do I add the Heroku Platform MCP server to Cursor?

Heroku documents a Cursor config; copy it from the Cursor section of this page. Snippets for VS Code and Generic are there too.

Does the Heroku Platform MCP server need authentication?

Yes, API key. Transport: stdio. Status: Preview, last checked October 17, 2026.

Sources

Last verified against 5 Heroku pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.