Heroku Platform MCP Server
Official Heroku MCP server: apps, dynos, add-ons, pipelines, logs and Postgres through the Heroku CLI
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 locksLimitations
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 | |
|---|---|
| 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.
Related
An MCP server built into the Netdata agent: metrics, logs, alerts and live process, service and container data for an AI assistant
GitHub's official MCP server: code, issues, pull requests, Actions and security alerts straight from the agent
A GitHub Action that runs Claude Code in pull requests and issues: answers mentions, reviews and makes changes
An AI assistant for Kubernetes that turns plain-language requests into kubectl operations and doubles as an MCP server