heroku-mcp-server

@andyciggy

About heroku-mcp-server

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

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`.