heroku-mcp-server

What is heroku-mcp-server?

heroku-mcp-server is a Model Context Protocol (MCP) server that enables large language models (LLMs) to read, manage, and operate Heroku Platform resources. It works on Common Runtime, Cedar Private and Shield Spaces, and Fir Private Spaces. The server is currently in early development.

How to use heroku-mcp-server?

Install and run via npx (npx -y @heroku/mcp-server) and set the HEROKU_API_KEY environment variable with a Heroku authorization token. Add the server configuration (as shown in the README) to your MCP client (e.g., Claude Desktop, Zed, Cursor, Windsurf, Cline, VSCode, or Trae).

Key features of heroku-mcp-server

• Direct LLM-driven interaction with Heroku Platform resources
• Secure, authenticated access via Heroku CLI tokens
• Natural language interface for Heroku operations
• Application management (list, create, rename, transfer, deploy)
• Process and dyno management (list, scale, restart)
• Add-on provisioning and management
• Maintenance mode and application logs
• Pipeline management (create, promote, list, info)
• PostgreSQL database management (SQL queries, info, backups, upgrade)

Use cases of heroku-mcp-server

• Deploy and manage Heroku apps using natural language commands
• Scale dynos and restart processes via an LLM
• Provision and inspect add-ons
• Run SQL queries and manage PostgreSQL databases
• Control maintenance mode and view application logs

FAQ from heroku-mcp-server

How do I authenticate heroku-mcp-server?

Generate a Heroku authorization token via the CLI (heroku authorizations:create or heroku auth:token) or from the Heroku Dashboard (Account Settings > Applications > Authorizations). Use the token as your HEROKU_API_KEY.

What runtime dependencies does heroku-mcp-server require?

It requires Node.js and npx to run the @heroku/mcp-server package. The Heroku CLI is used for token generation but not required at runtime.

Does heroku-mcp-server work with all Heroku runtimes?

It works on Common Runtime, Cedar Private and Shield Spaces, and Fir Private Spaces.

What transport does heroku-mcp-server use?

It uses stdio transport, as configured in the MCP client snippets.

Is heroku-mcp-server stable?

It is currently in early development; tools and functionality may evolve.