← All labs

Heroku

by docker ✓ verified ✓ Packaged by Docker

Heroku Platform MCP Server using the Heroku CLI.

MCP server installable needs setup network: on runtime: sysbox

DevOps MCP Servers

Heroku MCP Server

Heroku Platform MCP Server using the Heroku CLI.

What is an MCP Server?

MCP Info

Attribute	Details
Docker Image	mcp/heroku
Author	heroku
Repository	https://github.com/heroku/heroku-mcp-server

Image Building Info

Attribute	Details
Dockerfile	https://github.com/heroku/heroku-mcp-server/blob/f4949381035a04cb862b323ed024762bd2bb12aa/Dockerfile
Commit	`f4949381035a04cb862b323ed024762bd2bb12aa`
Docker Image built by	Docker Inc.
Docker Scout Health Score	Docker Scout Health Score
Verify Signature	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/heroku --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub`
Licence	Apache License 2.0

Available Tools (34)

Tools provided by this Server	Short Description
`create_addon`	Create add-on: specify service, plan, custom names
`create_app`	Create app: custom name, region (US/EU), team, private space
`deploy_one_off_dyno`	Run code/commands in Heroku one-off dyno with network and filesystem access.
`deploy_to_heroku`	Use for all deployments.
`get_addon_info`	Get add-on details: plan, state, billing
`get_app_info`	Get app details: config, dynos, addons, access, domains
`get_app_logs`	App logs: monitor/debug/filter by dyno/process/source
`list_addon_plans`	List service plans: features, pricing, availability
`list_addon_services`	List available add-on services and features
`list_addons`	List add-ons: all apps or specific app, detailed metadata
`list_apps`	List Heroku apps: owned, collaborator access, team/space filtering
`list_private_spaces`	Lists Heroku Private Spaces with CIDR blocks, regions, compliance and capacity details.
`list_teams`	Lists accessible Heroku Teams.
`maintenance_off`	Disable maintenance mode and restore normal app operations
`maintenance_on`	Enable maintenance mode and redirect traffic for a Heroku app
`pg_backups`	Manage backups: schedules, status, verification, recovery
`pg_credentials`	Manage access: credentials, permissions, security, monitoring
`pg_info`	View database status: config, metrics, resources, health
`pg_kill`	Stop processes: stuck queries, blocking transactions, runaway operations
`pg_locks`	Analyze locks: blocked queries, deadlocks, concurrency
`pg_maintenance`	Track maintenance: windows, schedules, progress, planning
`pg_outliers`	Find resource-heavy queries: performance, patterns, optimization
`pg_ps`	Monitor active queries: progress, resources, performance
`pg_psql`	Execute SQL queries: analyze, debug, modify schema, manage data
`pg_upgrade`	Upgrade PostgreSQL: version migration, compatibility, safety
`pipelines_create`	Creates new Heroku deployment pipeline with configurable stages, apps, and team settings
`pipelines_info`	Displays detailed pipeline configuration, stages, and connected applications
`pipelines_list`	Lists accessible Heroku pipelines with ownership and configuration details
`pipelines_promote`	Promotes apps between pipeline stages with configurable target applications
`ps_list`	List and monitor Heroku app dynos.
`ps_restart`	Restart Heroku app processes.
`ps_scale`	Scale Heroku app dynos.
`rename_app`	Rename app: validate and update app name
`transfer_app`	Transfer app ownership to user/team

Tools Details

Tool: `create_addon`

Create add-on: specify service, plan, custom names

Parameters	Type	Description
`app`	`string`	Target app for add-on. Must have write access. Region/space affects availability
`serviceAndPlan`	`string`	Format: service_slug:plan_slug (e.g., heroku-postgresql:essential-0)
`as`	`string` optional	Custom attachment name. Used for config vars prefix. Must be unique in app
`name`	`string` optional	Global add-on identifier. Must be unique across all Heroku add-ons

Tool: `create_app`

Create app: custom name, region (US/EU), team, private space

Parameters	Type	Description
`app`	`string` optional	App name. Auto-generated if omitted
`region`	`string` optional	Region: us/eu. Default: us. Excludes space param
`space`	`string` optional	Private space name. Inherits region. Excludes region param
`team`	`string` optional	Team name for ownership

Tool: `deploy_one_off_dyno`

Run code/commands in Heroku one-off dyno with network and filesystem access.

Requirements:

Show command output
Use app_info for buildpack detection
Support shell setup commands
Use stdout/stderr

Features:

Network/filesystem access
Environment variables
File operations
Temp directory handling

Usage:

Use Heroku runtime
Proper syntax/imports
Organized code structure
Package management:
- Define dependencies
- Minimize external deps
- Prefer native modules

Example package.json:

{
  "type": "module",
  "dependencies": {
    "axios": "^1.6.0"
  }
}

Parameters	Type	Description
`command`	`string`	Command to run in dyno.
`name`	`string`	Target Heroku app name.
`env`	`object` optional	Dyno environment variables.
`size`	`string` optional	Dyno size.
`sources`	`array` optional	Source files to include in dyno.
`timeToLive`	`number` optional	Dyno lifetime in seconds.

Tool: `deploy_to_heroku`

Use for all deployments. Deploys new/existing apps, with or without teams/spaces, and env vars to Heroku. Ask for app name if missing. Requires valid app.json via appJson param.

Parameters	Type	Description
`appJson`	`string`	App.json config for deployment. Must follow schema: {"default":{"$schema":"http://json-schema.org/draft-07/schema#","title":"Heroku app.json Schema","description":"app.json is a manifest format for describing web apps. It declares environment variables, add-ons, and other information required to run an app on Heroku. Used for dynamic configurations or converted projects","type":"object","properties":{"name":{"type":"string","pattern":"^[a-zA-Z-\.]+","maxLength":300},"description":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"website":{"$ref":"#/definitions/uriString"},"repository":{"$ref":"#/definitions/uriString"},"logo":{"$ref":"#/definitions/uriString"},"success_url":{"type":"string"},"scripts":{"$ref":"#/definitions/scripts"},"env":{"$ref":"#/definitions/env"},"formation":{"$ref":"#/definitions/formation"},"addons":{"$ref":"#/definitions/addons"},"buildpacks":{"$ref":"#/definitions/buildpacks"},"environments":{"$ref":"#/definitions/environments"},"stack":{"$ref":"#/definitions/stack"},"image":{"type":"string"}},"additionalProperties":false,"definitions":{"uriString":{"type":"string","format":"uri"},"scripts":{"type":"object","properties":{"postdeploy":{"type":"string"},"pr-predestroy":{"type":"string"}},"additionalProperties":false},"env":{"type":"object","patternProperties":{"^[A-Z][A-Z0-9]*$":{"type":"object","properties":{"description":{"type":"string"},"value":{"type":"string"},"required":{"type":"boolean"},"generator":{"type":"string","enum":["secret"]}},"additionalProperties":false}}},"dynoSize":{"type":"string","enum":["free","eco","hobby","basic","standard-1x","standard-2x","performance-m","performance-l","private-s","private-m","private-l","shield-s","shield-m","shield-l"]},"formation":{"type":"object","patternProperties":{"^[a-zA-Z0-9_-]+$":{"type":"object","properties":{"quantity":{"type":"integer","minimum":0},"size":{"$ref":"#/definitions/dynoSize"}},"required":["quantity"],"additionalProperties":false}}},"addons":{"type":"array","items":{"oneOf":[{"type":"string"},{"type":"object","properties":{"plan":{"type":"string"},"as":{"type":"string"},"options":{"type":"object"}},"required":["plan"],"additionalProperties":false}]}},"buildpacks":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"],"additionalProperties":false}},"environmentConfig":{"type":"object","properties":{"env":{"type":"object"},"formation":{"type":"object"},"addons":{"type":"array"},"buildpacks":{"type":"array"}}},"environments":{"type":"object","properties":{"test":{"allOf":[{"$ref":"#/definitions/environmentConfig"},{"type":"object","properties":{"scripts":{"type":"object","properties":{"test":{"type":"string"}},"additionalProperties":false}}}]},"review":{"$ref":"#/definitions/environmentConfig"},"production":{"$ref":"#/definitions/environmentConfig"}},"additionalProperties":false},"stack":{"type":"string","enum":["heroku-18","heroku-20","heroku-22","heroku-24"]}}}}
`name`	`string`	App name for deployment. Creates new app if not exists.
`rootUri`	`string`	Workspace root directory path.
`env`	`object` optional	Environment variables overriding app.json values
`internalRouting`	`boolean` optional	Enable internal routing in private spaces.
`spaceId`	`string` optional	Private space ID for space deployments.
`tarballUri`	`string` optional	URL of deployment tarball. Creates from rootUri if not provided.
`teamId`	`string` optional	Team ID for team deployments.

Tool: `get_addon_info`

Get add-on details: plan, state, billing

Parameters	Type	Description
`addon`	`string`	Add-on identifier: UUID, name (postgresql-curved-12345), or attachment name (DATABASE)
`app`	`string` optional	App context for add-on lookup. Required for attachment names. Uses Git remote default

Tool: `get_app_info`

Get app details: config, dynos, addons, access, domains

Parameters	Type	Description
`app`	`string`	Target app name. Requires access permissions
`json`	`boolean` optional	JSON output with full metadata. Default: text format

Tool: `get_app_logs`

App logs: monitor/debug/filter by dyno/process/source

Parameters	Type	Description
`app`	`string`	Heroku app name. Requires: permissions, Cedar-gen
`dynoName`	`string` optional	Format: web.1/worker.2. Excludes processType
`processType`	`string` optional	web
`source`	`string` optional	app=application, heroku=platform. Default: all

Tool: `list_addon_plans`

List service plans: features, pricing, availability

Parameters	Type	Description
`service`	`string`	Service slug (e.g., heroku-postgresql). Get from list_addon_services
`json`	`boolean` optional	JSON output with pricing, features, space compatibility. Default: text format

Tool: `list_addon_services`

List available add-on services and features

Parameters	Type	Description
`json`	`boolean` optional	JSON output with sharing options and app generation support. Default: basic text

Tool: `list_addons`

List add-ons: all apps or specific app, detailed metadata

Parameters	Type	Description
`all`	`boolean` optional	List all add-ons across accessible apps. Overrides app param, shows full status
`app`	`string` optional	Filter by app name. Shows add-ons and attachments. Uses Git remote default if omitted

Tool: `list_apps`

List Heroku apps: owned, collaborator access, team/space filtering

Parameters	Type	Description
`all`	`boolean` optional	Show owned apps and collaborator access. Default: owned only
`personal`	`boolean` optional	List personal account apps only, ignoring default team
`space`	`string` optional	Filter by private space name. Excludes team param
`team`	`string` optional	Filter by team name. Excludes space param

Tool: `list_private_spaces`

Lists Heroku Private Spaces with CIDR blocks, regions, compliance and capacity details. JSON output supported.

Parameters	Type	Description
`json`	`boolean` optional	JSON output for detailed space metadata, text output if false/omitted

Tool: `list_teams`

Lists accessible Heroku Teams. Use for: viewing teams, checking membership, getting team metadata, and verifying access. JSON output available.

Parameters	Type	Description
`json`	`boolean` optional	Output format control - true for detailed JSON with team metadata, false/omitted for simplified text

Tool: `maintenance_off`

Disable maintenance mode and restore normal app operations

Parameters	Type	Description
`app`	`string`	Target Heroku app name

Tool: `maintenance_on`

Enable maintenance mode and redirect traffic for a Heroku app

Parameters	Type	Description
`app`	`string`	Target Heroku app name

Tool: `pg_backups`

Manage backups: schedules, status, verification, recovery

Parameters	Type	Description
`app`	`string`	Target app name

Tool: `pg_credentials`

Manage access: credentials, permissions, security, monitoring

Parameters	Type	Description
`app`	`string`	Target app name
`database`	`string` optional	Database identifier. Format: APP_NAME::DB for other apps. Default: DATABASE_URL

Tool: `pg_info`

View database status: config, metrics, resources, health

Parameters	Type	Description
`app`	`string`	Target app name
`database`	`string` optional	Database identifier. Format: APP_NAME::DB for other apps. Default: all databases

Tool: `pg_kill`

Stop processes: stuck queries, blocking transactions, runaway operations

Parameters	Type	Description
`app`	`string`	Target app name
`pid`	`number`	Process ID to terminate
`database`	`string` optional	Database identifier. Format: APP_NAME::DB for other apps. Default: DATABASE_URL
`force`	`boolean` optional	Force immediate termination

Tool: `pg_locks`

Analyze locks: blocked queries, deadlocks, concurrency

Parameters	Type	Description
`app`	`string`	Target app name
`database`	`string` optional	Database identifier. Format: APP_NAME::DB for other apps. Default: DATABASE_URL
`truncate`	`boolean` optional	Truncate queries to 40 chars

Tool: `pg_maintenance`

Track maintenance: windows, schedules, progress, planning

Parameters	Type	Description
`app`	`string`	Target app name
`database`	`string` optional	Database identifier. Format: APP_NAME::DB for other apps. Default: DATABASE_URL

Tool: `pg_outliers`

Find resource-heavy queries: performance, patterns, optimization

Parameters	Type	Description
`app`	`string`	Target app name
`database`	`string` optional	Database identifier. Format: APP_NAME::DB for other apps. Default: DATABASE_URL
`num`	`number` optional	Number of queries to show. Default: 10
`reset`	`boolean` optional	Reset pg_stat_statements stats
`truncate`	`boolean` optional	Truncate queries to 40 chars

Tool: `pg_ps`

Monitor active queries: progress, resources, performance

Parameters	Type	Description
`app`	`string`	Target app name
`database`	`string` optional	Database identifier. Format: APP_NAME::DB for other apps. Default: DATABASE_URL
`verbose`	`boolean` optional	Show query plan and memory usage

Tool: `pg_psql`

Execute SQL queries: analyze, debug, modify schema, manage data

Parameters	Type	Description
`app`	`string`	app to run command against
`command`	`string` optional	SQL command. Single line. Ignored if file provided
`credential`	`string` optional	credential to use
`database`	`string` optional	Database identifier: config var, name, ID, alias. Format: APP_NAME::DB for other apps. Default: DATABASE_URL
`file`	`string` optional	SQL file path. Ignored if command provided

Tool: `pg_upgrade`

Upgrade PostgreSQL: version migration, compatibility, safety

Parameters	Type	Description
`app`	`string`	Target app name
`confirm`	`string` optional	Confirmation for destructive operation
`database`	`string` optional	Database identifier. Format: APP_NAME::DB for other apps. Default: DATABASE_URL
`version`	`string` optional	PostgreSQL version target

Tool: `pipelines_create`

Creates new Heroku deployment pipeline with configurable stages, apps, and team settings

Parameters	Type	Description
`name`	`string`	Pipeline name
`stage`	`string`	Initial pipeline stage
`app`	`string` optional	App to add to pipeline
`team`	`string` optional	Team owning the pipeline

Tool: `pipelines_info`

Displays detailed pipeline configuration, stages, and connected applications

Parameters	Type	Description
`pipeline`	`string`	Target pipeline name
`json`	`boolean` optional	Enable JSON output

Tool: `pipelines_list`

Lists accessible Heroku pipelines with ownership and configuration details

Parameters	Type	Description
`json`	`boolean` optional	Enable JSON output

Tool: `pipelines_promote`

Promotes apps between pipeline stages with configurable target applications

Parameters	Type	Description
`app`	`string`	Source app for promotion
`to`	`string` optional	Target apps for promotion (comma-separated)

Tool: `ps_list`

List and monitor Heroku app dynos. View running dynos, check status/health, monitor process states, verify configurations.

Parameters	Type	Description
`app`	`string`	App name to list processes for
`json`	`boolean` optional	Output process info in JSON format

Tool: `ps_restart`

Restart Heroku app processes. Restart specific dynos, process types, or all dynos. Reset dyno states selectively.

Parameters	Type	Description
`app`	`string`	App name to restart processes for
`dyno-name`	`string` optional	Specific dyno to restart (e.g., web.1). Omit both options to restart all
`process-type`	`string` optional	Dyno type to restart (e.g., web). Omit both options to restart all

Tool: `ps_scale`

Scale Heroku app dynos. Adjust quantities, change sizes, view formation details, manage resources.

Parameters	Type	Description
`app`	`string`	App name to scale
`dyno`	`string` optional	Dyno type and quantity (e.g., web=3:Standard-2X, worker+1). Omit to show current formation

Tool: `rename_app`

Rename app: validate and update app name

Parameters	Type	Description
`app`	`string`	Current app name. Requires access
`newName`	`string`	New unique app name

Tool: `transfer_app`

Transfer app ownership to user/team

Parameters	Type	Description
`app`	`string`	App to transfer. Requires owner/admin access
`recipient`	`string`	Target user email or team name

Use this MCP Server

{
  "mcpServers": {
    "heroku": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HEROKU_API_KEY",
        "mcp/heroku"
      ],
      "env": {
        "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?

Install

Open LabStore on any connected Selfmade Ninja Labs instance and press Get — or run this from the instance shell:

labsctl store-install mcp-heroku

About

Kind: MCP server
Publisher: docker
Version: 5b32f89f920a
Updated: 13 Oct 2026
Transport: stdio
Licence: Apache License 2.0
Owner: heroku
Packaged by: Docker

Secrets needed

HEROKU_API_KEY: heroku.api_key

Tools (34)

create_addon: Create add-on: specify service, plan, custom names
create_app: Create app: custom name, region (US/EU), team, private space
deploy_one_off_dyno: Run code/commands in Heroku one-off dyno with network and filesystem access. Requirements: - Show command output - Use app_info for buildpack detection - Suppo
deploy_to_heroku: Use for all deployments. Deploys new/existing apps, with or without teams/spaces, and env vars to Heroku. Ask for app name if missing. Requires valid app.json v
get_addon_info: Get add-on details: plan, state, billing
get_app_info: Get app details: config, dynos, addons, access, domains
get_app_logs: App logs: monitor/debug/filter by dyno/process/source
list_addon_plans: List service plans: features, pricing, availability
list_addon_services: List available add-on services and features
list_addons: List add-ons: all apps or specific app, detailed metadata
list_apps: List Heroku apps: owned, collaborator access, team/space filtering
list_private_spaces: Lists Heroku Private Spaces with CIDR blocks, regions, compliance and capacity details. JSON output supported.
list_teams: Lists accessible Heroku Teams. Use for: viewing teams, checking membership, getting team metadata, and verifying access. JSON output available.
maintenance_off: Disable maintenance mode and restore normal app operations
maintenance_on: Enable maintenance mode and redirect traffic for a Heroku app
pg_backups: Manage backups: schedules, status, verification, recovery
pg_credentials: Manage access: credentials, permissions, security, monitoring
pg_info: View database status: config, metrics, resources, health
pg_kill: Stop processes: stuck queries, blocking transactions, runaway operations
pg_locks: Analyze locks: blocked queries, deadlocks, concurrency
pg_maintenance: Track maintenance: windows, schedules, progress, planning
pg_outliers: Find resource-heavy queries: performance, patterns, optimization
pg_ps: Monitor active queries: progress, resources, performance
pg_psql: Execute SQL queries: analyze, debug, modify schema, manage data
pg_upgrade: Upgrade PostgreSQL: version migration, compatibility, safety
pipelines_create: Creates new Heroku deployment pipeline with configurable stages, apps, and team settings
pipelines_info: Displays detailed pipeline configuration, stages, and connected applications
pipelines_list: Lists accessible Heroku pipelines with ownership and configuration details
pipelines_promote: Promotes apps between pipeline stages with configurable target applications
ps_list: List and monitor Heroku app dynos. View running dynos, check status/health, monitor process states, verify configurations.
ps_restart: Restart Heroku app processes. Restart specific dynos, process types, or all dynos. Reset dyno states selectively.
ps_scale: Scale Heroku app dynos. Adjust quantities, change sizes, view formation details, manage resources.
rename_app: Rename app: validate and update app name
transfer_app: Transfer app ownership to user/team

Source

View upstream ↗

View repository ↗

image mcp/heroku@sha256:bc972fc22f0091b9719b672613f6544f0b3752c86c27f63872a44f933f5fa8e0

digest sha256:bc972fc22f0091b9719…

Every store app is stripped of privileged/host-mount settings at install and runs contained on the installing host. The rules.

Heroku MCP Server

MCP Info

Image Building Info

Available Tools (34)

Tools Details

Tool: create_addon

Tool: create_app

Tool: deploy_one_off_dyno

Tool: deploy_to_heroku

Tool: get_addon_info

Tool: get_app_info

Tool: get_app_logs

Tool: list_addon_plans

Tool: list_addon_services

Tool: list_addons

Tool: list_apps

Tool: list_private_spaces

Tool: list_teams

Tool: maintenance_off

Tool: maintenance_on

Tool: pg_backups

Tool: pg_credentials

Tool: pg_info

Tool: pg_kill

Tool: pg_locks

Tool: pg_maintenance

Tool: pg_outliers

Tool: pg_ps

Tool: pg_psql

Tool: pg_upgrade

Tool: pipelines_create

Tool: pipelines_info

Tool: pipelines_list

Tool: pipelines_promote

Tool: ps_list

Tool: ps_restart

Tool: ps_scale

Tool: rename_app

Tool: transfer_app