heroku-mcp-server

What is heroku-mcp-server?

The Heroku Platform MCP Server is a Model Context Protocol (MCP) implementation that enables large language models (LLMs) to read, manage, and operate Heroku Platform resources through natural language. It works on Common Runtime, Cedar Private and Shield Spaces, and Fir Private Spaces, and is intended for developers and teams who want to interact with Heroku via conversational AI.

How to use heroku-mcp-server?

Install the Heroku CLI (version 10.8.1 or higher). Then launch the server either with heroku mcp:start (recommended, uses existing CLI authentication) or with npx -y @heroku/mcp-server after setting the HEROKU_API_KEY environment variable. Configure your MCP client (Claude Desktop, Zed, Cursor, Windsurf, Cline, VS Code, or Trae) with one of the provided command examples.

Key features of heroku-mcp-server

• Manage apps: list, create, rename, transfer, deploy with app.json
• Scale, restart, and resize dynos
• Provision and inspect add-ons
• Toggle maintenance mode and view logs
• Create, promote, and list pipelines
• List teams and private spaces
• Execute SQL and manage PostgreSQL databases (pg_psql, pg_info, pg_locks, etc.)
• Authenticate via Heroku CLI session or API key

Use cases of heroku-mcp-server

• Deploy and monitor Heroku apps using natural language
• Scale dynos and troubleshoot performance without leaving the LLM interface
• Manage PostgreSQL databases: run queries, view locks, kill processes
• Automate pipeline promotions and team/space management
• Integrate Heroku resource management into chat-based developer workflows

FAQ from heroku-mcp-server

What prerequisites are needed?

Heroku CLI version 10.8.1 or higher must be installed globally on your system.

How do I authenticate the server?

You can use heroku mcp:start to authenticate with your existing Heroku CLI session, or set the HEROKU_API_KEY environment variable with a Heroku authorization token when using npx -y @heroku/mcp-server.

Which MCP clients are supported?

Claude Desktop, Zed, Cursor, Windsurf, Cline, VS Code, and Trae are explicitly supported with configuration examples in the README.

What Heroku runtimes are supported?

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

Is the server stable?

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