Heroku MCP Server: Setup for Claude, Cursor and Other Apps

• Lists your Heroku apps

  Lists apps, filtered by personal, collaborator, team or space.

  Try: “List my Heroku apps.”

  Read · list_apps

• Shows one app's setup

  Returns an app's configuration, dynos and add-ons.

  Try: “Show me the setup of my-shop-api.”

  Read · get_app_info

• Reads an app's logs

  Shows the application logs.

  Try: “Show the last errors in the logs of my-shop-api.”

  Read · get_app_logs

• Creates an app

  Creates a new app with the region, team and space you choose.

  Try: “Create an app called my-shop-staging in the eu region.”

  Write · create_app

• Renames an app

  Renames an existing app.

  Try: “Rename my-shop-staging to my-shop-test.”

  Write · rename_app

• Transfers an app to someone else

  Moves ownership of an app to another user or team.

  Try: “Transfer my-shop-test to the Platform team.”

  Write · transfer_app

• Deploys a project

  Deploys a project using its app.json, including team, private space and environment settings.

  Try: “Deploy this project to a new Heroku app.”

  Write · deploy_to_heroku

• Runs a script on a temporary dyno

  Runs code or commands in a sandbox on a one-off dyno, with optional files, network access and variables. It cleans up afterwards.

  Try: “Run this migration script on a one-off dyno.”

  Runs code · deploy_one_off_dyno

• Lists an app's dynos

  Shows all dynos of an app.

  Try: “What dynos are running for my-shop-api?”

  Read · ps_list

• Scales or resizes dynos

  Changes how many dynos run, or their size.

  Try: “Scale the web dynos of my-shop-api to 3.”

  Write · ps_scale

• Restarts dynos

  Restarts chosen dynos, a process type, or all dynos.

  Try: “Restart all dynos for my-shop-api.”

  Write · ps_restart

• Lists add-ons

  Lists add-ons across all apps or for one app.

  Try: “Which add-ons does my-shop-api use?”

  Read · list_addons

• Shows one add-on

  Returns details of an add-on.

  Try: “Show details of the Postgres add-on on my-shop-api.”

  Read · get_addon_info

• Adds an add-on

  Provisions a new add-on for an app.

  Try: “Add a Redis add-on to my-shop-api.”

  Write · create_addon

• Turns maintenance mode on

  Puts an app into maintenance mode.

  Try: “Turn on maintenance mode for my-shop-api.”

  Write · maintenance_on

• Turns maintenance mode off

  Takes an app out of maintenance mode.

  Try: “Turn off maintenance mode for my-shop-api.”

  Write · maintenance_off

• Lists pipelines

  Lists the pipelines you can see.

  Try: “List my pipelines.”

  Read · pipelines_list

• Shows one pipeline

  Returns detailed information about a pipeline.

  Try: “Show the my-shop pipeline.”

  Read · pipelines_info

• Creates a pipeline

  Creates a new pipeline.

  Try: “Create a pipeline called my-shop.”

  Write · pipelines_create

• Promotes apps to the next stage

  Promotes apps to the next stage of a pipeline.

  Try: “Promote staging to production in the my-shop pipeline.”

  Write · pipelines_promote

• Lists your teams

  Lists the teams you belong to.

  Try: “Which Heroku teams am I in?”

  Read · list_teams

• Lists private spaces

  Lists the spaces available to you.

  Try: “List my private spaces.”

  Read · list_private_spaces

• Shows database details

  Displays detailed information about a Heroku Postgres database.

  Try: “Show info about the database of my-shop-api.”

  Read · pg_info

• Shows running queries

  Shows active queries and how they are running.

  Try: “What queries are running on my-shop-api's database?”

  Read · pg_ps

• Finds database locks

  Shows locks and which transactions block others.

  Try: “Is anything blocking queries on my-shop-api's database?”

  Read · pg_locks

• Finds the slowest queries

  Identifies queries that use the most resources.

  Try: “Which queries use the most resources?”

  Read · pg_outliers

• Shows database maintenance info

  Shows maintenance information for the database.

  Try: “When is the next maintenance for my database?”

  Read · pg_maintenance

• Runs SQL on your database

  Runs the SQL you or the assistant write against a Heroku Postgres database. SQL can read, change and delete data.

  Try: “Count the orders created today in my-shop-api's database.”

  Delete · pg_psql

• Manages database credentials

  Manages database credentials and access.

  Try: “List the credentials for my database.”

  Write · pg_credentials

• Stops a database process

  Terminates a specific database process.

  Try: “Kill the long running query that is blocking others.”

  Runs code · pg_kill

• Manages database backups

  Manages database backups and their schedules.

  Try: “Show the backup schedule for my database.”

  Delete · pg_backups

• Upgrades Postgres

  Upgrades the database to a newer PostgreSQL version.

  Try: “Upgrade my database to the latest version.”

  Write · pg_upgrade

Watch out for

• It can run any SQL on your Postgres database

  The SQL tool can change or delete data as well as read it. Point it at a follower or staging database when you can. raw.githubusercontent.com

• It can deploy, scale and restart live apps

  These actions affect production traffic at once. Keep approval prompts on for changes. raw.githubusercontent.com

• It can upgrade a database and kill processes

  Database upgrade and process termination are available as tools. Ask the assistant to explain before you approve them. raw.githubusercontent.com

Security advisories