Heroku

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
HEROKU_API_KEYYesHeroku API token (from 'heroku authorizations:create' or the Account page) Docs.

Setup

  1. Sign in to Heroku: Go to https://dashboard.heroku.com and sign in (an Eco/Basic app is enough for testing; SSO-federated users must use a separate non-federated account for API tokens).
  2. Create an API token: With the Heroku CLI, run 'heroku authorizations:create -d "veryfront token"' for a non-expiring OAuth token, or 'heroku auth:token' for a token valid up to one year.
  3. Set the environment variable: Add the token to your .env as HEROKU_API_KEY=...
  4. Verify access: Run List Apps, then List Dynos with one of your app names.

Provider notes

  • Every request must send 'Accept: application/vnd.heroku+json; version=3' - tools include this header by default
  • Restarting dynos uses the DELETE method (DELETE /apps/{app}/dynos restarts all dynos; it does not delete the app)
  • List endpoints paginate with Range/Next-Range headers (max 1000 items per page) and return 206 Partial Content when truncated

Provider API reference.

Tools

ToolAccessDescription
List Apps<br /><code className="reference-identifier">heroku__list_apps</code>ReadList apps
Get App<br /><code className="reference-identifier">heroku__get_app</code>ReadGet app
List Dynos<br /><code className="reference-identifier">heroku__list_dynos</code>ReadList dynos
Restart Dyno<br /><code className="reference-identifier">heroku__restart_dyno</code>WriteRestart dyno
Restart All Dynos<br /><code className="reference-identifier">heroku__restart_all_dynos</code>WriteRestart all dynos
Get Config Vars<br /><code className="reference-identifier">heroku__get_config_vars</code>ReadGet config vars
List Releases<br /><code className="reference-identifier">heroku__list_releases</code>ReadList releases

Verify the connection

Call a read tool such as heroku__list_apps with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.