Heroku Platform MCP Server

Official Heroku MCP server: apps, dynos, add-ons, pipelines, logs and Postgres through the Heroku CLI

MCP serverHigh risk

heroku/heroku-mcp-server

Install

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

Recommended; reuses Heroku CLI authentication.

This is third-party code. Review the repository files before installing.

What it does

The server lets the agent manage the Heroku platform. The agent creates, renames and transfers apps, deploys projects from app.json and runs code on one-off dynos. It scales and restarts dynos, provisions add-ons, toggles maintenance mode and reads logs. For Heroku Postgres it runs SQL, shows active queries and locks, manages backups and upgrades versions.

Who it is for. For developers and teams whose apps run on Heroku.

Good fit when

  • You need logs and a restart for a crashed app
  • You need to find slow queries and locks in Heroku Postgres
  • You need to promote a build through a pipeline

Not a fit when

  • Your apps are not on Heroku
  • The agent must not run SQL or kill processes in a production database

Example request

Show recent logs for my-shop and check its database for locks

Limitations

Requires Heroku CLI 10.8.1 or later and a Heroku account. The project is in early development and tools may change. Heroku does not serve users in Russia, so the server is of no use without a VPN and a foreign account.

How to disable. Remove the heroku block from the MCP config and restart the client. If you used HEROKU_API_KEY, revoke the authorization in Heroku account settings.

MCP

Transport
stdio
Authentication
API key
Environment variables
Environment variables
HEROKU_API_KEY
secret
Heroku auth token, not needed with heroku mcp:start
MCP_SERVER_REQUEST_TIMEOUT
Command timeout in milliseconds, default 15000

Security check

  • Runs SQL and kills processes in Postgres databases
  • Scales, transfers and deploys apps
  • Runs arbitrary code on one-off dynos

README in short

The README covers two ways to run: heroku mcp:start with CLI auth, and npx with an API key. Each has configs for Claude Desktop, Zed, Cursor, Windsurf, Cline, VS Code and Trae. Tools are grouped by apps, dynos, add-ons, logs, pipelines, teams and Postgres. Apache 2.0 licensed.

FAQ

Do I need an API key?

Not with heroku mcp:start, which reuses the Heroku CLI session. npx -y @heroku/mcp-server needs HEROKU_API_KEY.

How do I get HEROKU_API_KEY?

Run heroku authorizations:create or heroku auth:token, or create one on the Applications tab of account settings.

Editors’ pick

An MCP server built into the Netdata agent: metrics, logs, alerts and live process, service and container data for an AI assistant

MCP serverMedium risk80.5K
Editors’ pick

GitHub's official MCP server: code, issues, pull requests, Actions and security alerts straight from the agent

MCP serverHigh risk32.9K
Editors’ pick

A GitHub Action that runs Claude Code in pull requests and issues: answers mentions, reviews and makes changes

PluginHigh risk8.9K
Editors’ pick

An AI assistant for Kubernetes that turns plain-language requests into kubectl operations and doubles as an MCP server

CLIHigh risk7.6K