Heroku

by heroku

69 stars
180 downloads
Not rated
GitHub

About

Interact with Heroku Platform resources securely using the Heroku CLI. Requires the Heroku CLI and a valid API key.

Details

Author
heroku
Repository
heroku/heroku-mcp-server
GitHub stars
69
Downloads
180
License
Apache License 2.0
Categories
Cloud Service, Infrastructure, API, AI, Developer Tools, Other
Tags
#integration

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Heroku
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @heroku/mcp-server
    Environment
    • HEROKU_API_KEY <YOUR_HEROKU_AUTH_TOKEN>

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Deploy

list_apps

List all Heroku apps. You can filter apps by personal, collaborator, team, or space.

get_app_info

Get detailed information about an app, including its configuration, dynos, and add-ons.

create_app

Create a new app with customizable settings for region, team, and space.

rename_app

Rename an existing app.

transfer_app

Transfer ownership of an app to another user or team.

deploy_to_heroku

Deploy projects to Heroku with an `app.json` configuration, supporting team deployments, private spaces, and environment setups.

deploy_one_off_dyno

Execute code or commands in a sandboxed environment on a Heroku one-off dyno. Supports file creation, network access, environment variables, and automatic cleanup.

ps_list

List all dynos for an app.

ps_scale

Scale the number of dynos up or down, or resize dynos.

ps_restart

Restart specific dynos, process types, or all dynos.

list_addons

List all add-ons for all apps or for a specific app.

get_addon_info

Get detailed information about a specific add-on.

create_addon

Provision a new add-on for an app.

maintenance_on

Enable maintenance mode for an app.

maintenance_off

Disable maintenance mode for an app.

get_app_logs

View application logs.

pipelines_create

Create a new pipeline.

pipelines_promote

Promote apps to the next stage in a pipeline.

pipelines_list

List available pipelines.

pipelines_info

Get detailed pipeline information.

list_teams

List teams you belong to.

list_private_spaces

List available spaces.

pg_psql

Execute SQL queries against the Heroku PostgreSQL database.

pg_info

Display detailed database information.

pg_ps

View active queries and execution details.

pg_locks

View database locks and identify blocking transactions.

pg_outliers

Identify resource-intensive queries.

pg_credentials

Manage database credentials and access.

pg_kill

Terminate specific database processes.

pg_maintenance

Show database maintenance information.

pg_backups

Manage database backups and schedules.

pg_upgrade

Upgrade PostgreSQL to a newer version.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

{
    "env": {
        "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>"
    },
    "args": [
        "/c",
        "npx",
        "-y",
        "@heroku/mcp-server"
    ],
    "command": "cmd"
}

Configure the Heroku Platform MCP Server withnpx -y @heroku/mcp-server

You can also launch the Heroku Platform MCP Server using thenpx -y @heroku/mcp-servercommand. This method requires you to set theHEROKU_API_KEYenvironment variable with your Herokuauthorization token.

Generate a Heroku authorization token with one of these methods:

Copy the token and use it as yourHEROKU_API_KEYin the following steps.
- Select your avatar, then selectAccount Settings.
- Open the Applications tab.
- Next toAuthorizations, clickCreate authorization.

Example configuration forClaude Desktop:

{ "mcpServers": { "heroku": { "command": "npx", "args": ["-y", "@heroku/mcp-server"], "env": { "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>" } } } }
{ "context_servers": { "heroku": { "command": { "path": "npx", "args": ["-y", "@heroku/mcp-server"], "env": { "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>" } } } } }
{ "mcpServers": { "heroku": { "command": "npx -y @heroku/mcp-server", "env": { "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>" } } } }
{ "mcpServers": { "heroku": { "command": "npx", "args": ["-y", "@heroku/mcp-server"], "env": { "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>" } } } }
{ "mcpServers": { "heroku": { "command": "npx", "args": ["-y", "@heroku/mcp-server"], "env": { "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>" } } } }
{ "mcp": { "servers": { "heroku": { "type": "stdio", "command": "npx", "args": ["-y", "@heroku/mcp-server"], "env": { "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>" } } } } }
{ "mcpServers": { "heroku": { "command": "npx", "args": ["-y", "@heroku/mcp-server"], "env": { "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>" } } } }

Note:When you usenpx -y @heroku/mcp-server, you must set theHEROKU_API_KEYenvironment variable with your Heroku authorization token.

- list_apps- List all Heroku apps. You can filter apps by personal, collaborator, team, or space.
- get_app_info- Get detailed information about an app, including its configuration, dynos, and add-ons.
- create_app- Create a new app with customizable settings for region, team, and space.
- rename_app- Rename an existing app.
- transfer_app- Transfer ownership of an app to another user or team.
- deploy_to_heroku- Deploy projects to Heroku with anapp.jsonconfiguration, supporting team deployments, private spaces, and environment setups.
- deploy_one_off_dyno- Execute code or commands in a sandboxed environment on a Heroku one-off dyno. Supports file creation, network access, environment variables, and automatic cleanup. Ideal for running scripts, tests, or temporary workloads.

- ps_list- List all dynos for an app.
- ps_scale- Scale the number of dynos up or down, or resize dynos.
- ps_restart- Restart specific dynos, process types, or all dynos.

- list_addons- List all add-ons for all apps or for a specific app.
- get_addon_info- Get detailed information about a specific add-on.
- create_addon- Provision a new add-on for an app.

- maintenance_on- Enable maintenance mode for an app.
- maintenance_off- Disable maintenance mode for an app.
- get_app_logs- View application logs.

- pipelines_create- Create a new pipeline.
- pipelines_promote- Promote apps to the next stage in a pipeline.
- pipelines_list- List available pipelines.
- pipelines_info- Get detailed pipeline information.

- list_teams- List teams you belong to.
- list_private_spaces- List available spaces.

- pg_psql- Execute SQL queries against the Heroku PostgreSQL database.
- pg_info- Display detailed database information.
- pg_ps- View active queries and execution details.
- pg_locks- View database locks and identify blocking transactions.
- pg_outliers- Identify resource-intensive queries.
- pg_credentials- Manage database credentials and access.
- pg_kill- Terminate specific database processes.
- pg_maintenance- Show database maintenance information.
- pg_backups- Manage database backups and schedules.
- pg_upgrade- Upgrade PostgreSQL to a newer version.

You can use theMCP inspectoror theVS Code Run and Debug functionto run and debug the server.
- Link the project as a global CLI usingnpm linkfrom the project root.
- Build withnpm run build:devor watch for file changes and build automatically withnpm run build:watch.

Use the MCP inspector with no breakpoints in the code:

# Breakpoints are not available npx @modelcontextprotocol/inspector heroku-mcp-server

Alternatively, if you installed the package in a specific directory or are actively developing on the Heroku MCP server:

cd /path/to/servers npx @modelcontextprotocol/inspector dist/index.js

Use the VS CodeRun and Debug launcherwith fully functional breakpoints in the code:
- Locate and select the run debug.
- Select the configuration labeled "MCP Server Launcher" in the dropdown.
- Select the run/debug button.

To set up local debugging with breakpoints:
-

Store your Heroku auth token in the VS Code user settings:

- Open the Command Palette (Cmd/Ctrl + Shift + P).
- TypePreferences: Open User Settings (JSON).
- Add the following snippet:

{ "heroku.mcp.authToken": "your-token-here" }
{ "version": "0.2.0", "configurations": [ { "type": "node", "request": "launch", "name": "MCP Server Launcher", "skipFiles": ["<node_internals>/"], "program": "${workspaceFolder}/node_modules/@modelcontextprotocol/inspector/bin/cli.js", "outFiles": ["${workspaceFolder}//dist//.js"], "env": { "HEROKU_API_KEY": "${config:heroku.mcp.authToken}", "DEBUG": "true" }, "args": ["heroku-mcp-server"], "sourceMaps": true, "console": "integratedTerminal", "internalConsoleOptions": "neverOpen", "preLaunchTask": "npm: build:watch" }, { "type": "node", "request": "attach", "name": "Attach to Debug Hook Process", "port": 9332, "skipFiles": ["<node_internals>/"], "sourceMaps": true, "outFiles": ["${workspaceFolder}/dist//.js"] }, { "type": "node", "request": "attach", "name": "Attach to REPL Process", "port": 9333, "skipFiles": ["<node_internals>/"], "sourceMaps": true, "outFiles": ["${workspaceFolder}/dist//.js"] } ], "compounds": [ { "name": "Attach to MCP Server", "configurations": ["Attach to Debug Hook Process", "Attach to REPL Process"] } ] }
{ "version": "2.0.0", "tasks": [ { "type": "npm", "script": "build:watch", "group": { "kind": "build", "isDefault": true }, "problemMatcher": ["$tsc"] } ] }

(Optional) Set breakpoints in your TypeScript files.

Press F5 or use theRun and Debug*sidebar.

Note: the debugger automatically builds your TypeScript files before launching.

The Heroku Platform MCP Server supports the following environment variables:

Your Heroku authorization token. Required for authentication with the Heroku Platform.

Timeout in milliseconds for command execution. Defaults to 15000 (15 seconds) if not set.

Example configuration with custom timeout:

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

Expose the entire ArgoCD API to LLMs via MCP using just 2 auto-generated tools powered by the OpenAPI spec.

An MCP server for interacting with the Coolify API to manage servers and applications.

Integrate with the Laravel Forge API to manage servers and deployments using MCP-compliant tools.

Manage Koyeb resources like apps, services, and deployments using the Koyeb API.

Interact with Render resources via LLMs using the Render API.

MCP server exposing Spinnaker CD platform via Gate API for pipeline and deployment management

Create, build, deploy, and manage Netlify resources using natural language.

European cloud hosting. Use your favorite AI coding assistant to easily deploy and manage apps on Ploi Cloud.

Simplifies framework deployments on various hosting environments, with a focus on shared hosting.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.