Heroku
Heroku Platform MCP Server using the Heroku CLI
What is Heroku?
Heroku is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to heroku platform mcp server using the heroku cli
Heroku Platform MCP Server using the Heroku CLI
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Heroku Platform MCP Server using the Heroku CLI
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @heroku/mcp-serverManual Installation
npx -y @heroku/mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Heroku
The Heroku MCP Server is an officially maintained integration from Heroku that gives AI assistants direct access to the Heroku Platform CLI, enabling natural language management of apps, dynos, pipelines, add-ons, PostgreSQL databases, and team resources. It covers the full application lifecycle from deployment and scaling to log access, maintenance mode, and database backup management. DevOps engineers and developers who manage Heroku deployments use it to perform common platform operations conversationally without switching to the CLI or dashboard.
Prerequisites
- Heroku CLI v10.8.1 or higher installed (run `heroku --version` to check)
- A Heroku account authenticated with the CLI (`heroku login`) or a HEROKU_API_KEY for the npx method
- Node.js and npx available if using the npx installation method
- An MCP-compatible client such as Claude Desktop or Cursor IDE
Install or update the Heroku CLI
The recommended installation method uses the Heroku CLI's built-in `heroku mcp:start` command, which requires CLI v10.8.1 or higher. Install or upgrade the CLI first.
# macOS via Homebrew:
brew tap heroku/brew && brew install heroku
# Upgrade if already installed:
brew upgrade heroku
# Verify version:
heroku --versionAuthenticate with Heroku
Log in to the Heroku CLI so `heroku mcp:start` can use your existing credentials. This is the recommended approach — no HEROKU_API_KEY env var is needed.
heroku loginConfigure your MCP client (recommended: heroku mcp:start)
Add the server to your claude_desktop_config.json using the `heroku mcp:start` command. This uses your existing CLI authentication automatically.
{
"mcpServers": {
"heroku": {
"command": "heroku",
"args": ["mcp:start"]
}
}
}Alternative: use npx with an API key
If you prefer not to install the CLI or need to authenticate with a token (e.g., in CI), use the npx method with a HEROKU_API_KEY. Get your API key from the Heroku dashboard under Account Settings.
{
"mcpServers": {
"heroku": {
"command": "npx",
"args": ["-y", "@heroku/mcp-server"],
"env": {
"HEROKU_API_KEY": "your-heroku-api-token-here"
}
}
}
}Restart your MCP client and verify
Restart Claude Desktop. The server exposes tools for app management, process scaling, add-ons, pipelines, logs, maintenance mode, team management, PostgreSQL operations, and more. Try asking about your apps to verify the connection.
Heroku Examples
Client configuration
Recommended Claude Desktop config using `heroku mcp:start` with CLI authentication.
{
"mcpServers": {
"heroku": {
"command": "heroku",
"args": ["mcp:start"]
}
}
}Prompts to try
Example natural language prompts for managing your Heroku platform.
- "List all my Heroku apps and show their current dyno counts"
- "Scale the web dyno for my-app to 2 instances"
- "Show the last 100 log lines for my-production-app"
- "Enable maintenance mode on my-staging-app"
- "Promote the app in the staging stage of my-pipeline to production"
- "Run a SQL query to count active users in the last 24 hours on my app's PostgreSQL database"
- "Show all active queries and locks on my Heroku Postgres database"Troubleshooting Heroku
'heroku mcp:start' command not found or CLI version too old
Upgrade the Heroku CLI to v10.8.1 or higher: `brew upgrade heroku` on macOS, or follow the official upgrade instructions at devcenter.heroku.com. Run `heroku --version` to confirm the version after upgrading.
Authentication errors: 'Invalid credentials' or 'Not logged in'
For the `heroku mcp:start` method, run `heroku login` in your terminal to refresh the CLI session. For the npx method, generate a new API key from your Heroku account settings and update the HEROKU_API_KEY in your MCP config.
Command timeouts for long-running operations
Set the MCP_SERVER_REQUEST_TIMEOUT environment variable in your MCP config's env block to a higher value (in milliseconds). The default is 15000 (15 seconds). For database operations or large deployments, try 60000 or higher.
Frequently Asked Questions about Heroku
What is Heroku?
Heroku is a Model Context Protocol (MCP) server that heroku platform mcp server using the heroku cli It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Heroku?
Install via npm with the command: npx -y @heroku/mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Heroku?
Heroku works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Heroku free to use?
Yes, Heroku is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
Heroku Alternatives — Similar Cloud Services Servers
Looking for alternatives to Heroku? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务,帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Heroku in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Heroku?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.