Heroku

v1.2.2Cloud Servicesstable

Heroku Platform MCP Server using the Heroku CLI

herokumcp
Share:
77
Stars
0
Downloads
0
Weekly
0/5

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

Manage Heroku platform operations through natural language.
Control deployments and app management via Heroku CLI.
heroku

Maintainer

LicenseApache 2.0
Languagetypescript
Versionv1.2.2
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y @heroku/mcp-server

Manual Installation

npx -y @heroku/mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

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
1

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 --version
2

Authenticate 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 login
3

Configure 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"]
    }
  }
}
4

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"
      }
    }
  }
}
5

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.

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.

Quick Config Preview

{ "mcpServers": { "heroku-mcp-server": { "command": "npx", "args": ["-y", "@heroku/mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

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.

33,000+ ServersFree & Open SourceStep-by-Step Guides