Heroku
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
Jump to
- 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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
HerokuCommand (node, npx, python, etc.)npxArguments-
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.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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
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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.

