MCP Heroku Server
Provides comprehensive application management through the Heroku Platform API, including tools for managing dynos (scaling and restarting), viewing deployment history and releases, accessing logs, and managing configuration variables and add-ons.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Heroku Server show me the last 50 log lines for my-web-app"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
βοΈ MCP Heroku Server
A complete Heroku management server for the Model Context Protocol (MCP). Provides comprehensive Heroku app management through the Heroku Platform API for AI assistants like Claude.
β¨ Features
π App Management - List, view, and manage your Heroku applications
π Deployment History - View releases and deployment timeline
π Dyno Operations - Scale, restart, and monitor dynos
π Log Access - Stream and filter application logs
π§ Configuration - Manage environment variables (config vars)
π¦ Add-on Management - List and monitor add-ons (databases, caches, etc.)
π Secure - Uses your Heroku API key with proper authentication
Related MCP server: HellΕ Admin MCP Server
π Prerequisites
Heroku CLI (optional, for generating API keys)
Node.js 16+ for running the MCP server
Heroku API Key - Get from Dashboard Account Settings
π Quick Start
Using with npx (recommended)
HEROKU_API_KEY=your-api-key npx @artik0din/mcp-herokuInstall globally
npm install -g @artik0din/mcp-heroku
export HEROKU_API_KEY=your-api-key
mcp-herokuπ§ Environment Variables
Set your Heroku API key:
Option 1: Environment Variable
export HEROKU_API_KEY=your-heroku-api-keyOption 2: .env file
cp .env.example .env
# Edit .env and add your HEROKU_API_KEYGetting Your API Key
Scroll to "API Key" section
Click "Reveal" to show your key
Or use CLI:
heroku auth:token
π§ MCP Client Setup
Add this server to your MCP client configuration:
Claude Desktop Configuration
{
"mcpServers": {
"heroku": {
"command": "npx",
"args": ["@artik0din/mcp-heroku"],
"env": {
"HEROKU_API_KEY": "your-heroku-api-key-here"
}
}
}
}Other MCP Clients
{
"name": "heroku",
"command": "npx",
"args": ["@artik0din/mcp-heroku"],
"env": {
"HEROKU_API_KEY": "your-heroku-api-key-here"
}
}π Available Tools
App Management
heroku_list_apps - List all your Heroku apps
team(string, optional) - Filter apps by team name
heroku_get_app - Get detailed app information
appName(string, required) - Name of the Heroku app
Deployment & Releases
heroku_list_releases - View deployment history
appName(string, required) - Name of the Heroku applimit(number) - Max releases to return (default: 10)
Dyno Management
heroku_restart - Restart app dynos
appName(string, required) - Name of the Heroku appdyno(string, optional) - Specific dyno (e.g., "web.1"), or omit for all
heroku_scale - Scale dynos up or down
appName(string, required) - Name of the Heroku appdyno(string, required) - Dyno type (e.g., "web", "worker")quantity(number, required) - Number of dynos to runsize(string, optional) - Dyno size (eco, basic, standard-1x, etc.)
Logs & Monitoring
heroku_get_logs - Retrieve application logs
appName(string, required) - Name of the Heroku applines(number) - Number of log lines (default: 100)dyno(string, optional) - Filter by dyno (e.g., "web.1")source(string, optional) - Filter by source ("app" or "heroku")
Add-ons
heroku_list_addons - List attached add-ons
appName(string, required) - Name of the Heroku app
Configuration
heroku_config_vars - Manage environment variables
appName(string, required) - Name of the Heroku appset(boolean) - Set to true to modify (default: false, just lists)key(string) - Config var key namevalue(string) - Config var value (use with set=true)
π‘ Usage Examples
List all apps
// Use the heroku_list_apps tool
// Returns array of apps with basic infoScale web dynos
// Use heroku_scale tool with:
// appName: "my-app"
// dyno: "web"
// quantity: 2
// size: "standard-1x"Get recent logs
// Use heroku_get_logs tool with:
// appName: "my-app"
// lines: 50
// source: "app"Set environment variable
// Use heroku_config_vars tool with:
// appName: "my-app"
// set: true
// key: "DATABASE_URL"
// value: "postgres://..."π Security
This server uses the Heroku Platform API securely:
API key is read from environment variables only
No credential storage or caching
All requests use HTTPS
Sensitive config vars are masked in responses
Uses official Heroku API endpoints
π οΈ Development
# Clone the repository
git clone https://github.com/artik0din/mcp-heroku.git
cd mcp-heroku
# Install dependencies
npm install
# Set environment variable
export HEROKU_API_KEY=your-key
# Build and run
npm run build
npm start
# Development mode
npm run devπ License
MIT License - see LICENSE file for details.
π€ Contributing
Contributions welcome! Please feel free to submit a Pull Request.
π Related
Available Tools
8 toolsheroku_config_varsC
Get or set config vars (environment variables) for a Heroku app.
Inputs: appName (required), set, key, value.
heroku_get_appC
Get detailed information about a Heroku app including dynos and formation.
Inputs: appName (required).
heroku_get_logsC
Get recent logs from a Heroku app. Can filter by dyno or source.
Inputs: appName (required), lines, dyno, source.
heroku_list_addonsA
List all add-ons attached to a Heroku app (databases, caches, etc.)
Inputs: appName (required).
heroku_list_appsB
List all Heroku apps. Optionally filter by team.
Inputs: team.
heroku_list_releasesC
List releases for a Heroku app. Shows deployment history.
Inputs: appName (required), limit.
heroku_restartB
Restart dynos for a Heroku app. Can restart all dynos or a specific one.
Inputs: appName (required), dyno.
heroku_scaleC
Scale dynos for a Heroku app. Change the number of running dynos.
Inputs: appName (required), dyno (required), quantity (required), size.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose targeting specific Heroku operations: config vars, app details, logs, add-ons, app listing, releases, restarting, and scaling. There is no overlap in functionality, and an agent can easily distinguish between them based on their specific resource and action combinations.
All tool names follow a consistent 'heroku_' prefix with a verb_noun pattern (e.g., heroku_get_app, heroku_list_addons). The naming is uniform across all eight tools, using snake_case throughout, making it predictable and easy to understand.
With 8 tools, this server is well-scoped for managing Heroku apps. Each tool serves a distinct and essential function in app management, covering monitoring, configuration, deployment, and scaling without being overly broad or too limited.
The tool set provides strong coverage for core Heroku app management, including monitoring (logs, releases), configuration (config vars, add-ons), and operations (restart, scale). A minor gap exists in CRUD operations for apps (e.g., create or delete an app), but agents can still handle most workflows effectively with the available tools.
Maintenance
Related MCP Connectors
Deploy your project to a live HTTPS URL from your AI tool; read logs, set variables, resize apps.
Deploy apps from GitHub, read build/runtime logs, and manage your app's users from your AI agent.
Manage Scalingo PaaS apps, deployments, containers, logs and env vars from your AI assistant.
Deploy and manage your apps, databases, storage, and scheduled jobs from your AI agent
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables management of Coolify instances to control applications, databases, and servers through the Model Context Protocol. It provides a comprehensive set of tools for deploying services and monitoring self-hosted infrastructure using natural language.1828 npm3MIT

HellΕ Admin MCP Serverofficial
AlicenseAqualityDmaintenanceEnables AI assistants to create and manage HellΕ applications with full developer context, supporting app creation, updates, secret generation, and logo management through a single unified tool.154 npm4MIT
Roar AI MCP Serverofficial
AlicenseNot gradedqualityBmaintenanceEnables AI assistants to deploy and manage hosted apps from git repos, read logs, add Postgres databases and domains, manage API keys and budgets, and send requests to 200+ AI models. Connects over remote Streamable HTTP with OAuth sign-in, so users need no API keys, installs, or local server.MIT- AlicenseBqualityCmaintenanceEnables AI agents to deploy and roll back applications, read build and runtime logs, diagnose broken apps, and run commands inside containers. It also manages environment variables, PostgreSQL databases, domains, cron jobs, marketplace services, and backups on a PaaS platform, with safety annotations so clients can confirm destructive actions.5813 npmMIT