☁️ 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

📋 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)

Install globally

🔧 Environment Variables

Set your Heroku API key:

Option 1: Environment Variable

Option 2: .env file

Getting Your API Key

1. Visit Heroku Dashboard Account Settings

2. Scroll to "API Key" section

3. Click "Reveal" to show your key

4. Or use CLI: heroku auth:token

🔧 MCP Client Setup

Add this server to your MCP client configuration:

Claude Desktop Configuration

Other MCP Clients

📚 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 app

  • limit (number) - Max releases to return (default: 10)

Dyno Management

• heroku_restart - Restart app dynos

  • appName (string, required) - Name of the Heroku app

  • dyno (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 app

  • dyno (string, required) - Dyno type (e.g., "web", "worker")

  • quantity (number, required) - Number of dynos to run

  • size (string, optional) - Dyno size (eco, basic, standard-1x, etc.)

Logs & Monitoring

• heroku_get_logs - Retrieve application logs

  • appName (string, required) - Name of the Heroku app

  • lines (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 app

  • set (boolean) - Set to true to modify (default: false, just lists)

  • key (string) - Config var key name

  • value (string) - Config var value (use with set=true)

💡 Usage Examples

List all apps

Scale web dynos

Get recent logs

Set environment variable

🔒 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

📝 License

MIT License - see LICENSE file for details.

🤝 Contributing

Contributions welcome! Please feel free to submit a Pull Request.

🔗 Related

• Heroku Platform API Documentation

• Model Context Protocol

• Heroku CLI