Make.com MCP Server — Build & Deploy Automation Scenarios with AI

⚠️ Disclaimer: This is an unofficial, community-driven project created by a passionate fan of Make.com. It is NOT affiliated with, endorsed by, or officially supported by Make.com.

A Model Context Protocol (MCP) server that gives AI assistants like Claude, GitHub Copilot, and Cursor full access to Make.com module documentation, scenario validation, and one-click deployment. Search 200+ automation modules across 40+ apps, build blueprints with auto-healing, and deploy directly to Make.com — all from your AI chat.

Features

• 🔍 200+ Modules — Full-text search across 200+ Make.com modules (Slack, Gmail, Google Sheets, Notion, OpenAI, and 35+ more apps)
• 📋 Module Details — Retrieve parameters, types, descriptions, and usage docs for any module
• ✅ Blueprint Validation — Check scenarios for missing parameters, unknown modules, structural issues, and router sub-routes before deploying
• 🛡️ Account-Aware Compatibility — Verify module IDs against your live Make account/region before deployment to prevent "Module not found" scenarios
• 🚀 Deploy to Make.com — Push validated blueprints directly to Make.com via API
• 🩹 Auto-Healing — Automatically fixes LLM-generated blueprints: injects missing metadata, adds designer coordinates, strips unsupported properties like router filter
• 🔀 Router Support — Full support for builtin:BasicRouter with multiple routes and recursive validation
• 📚 Scenario Templates — Browse reusable scenario templates for common workflows
• 📖 Guided Prompts — MCP prompts for guided scenario building and module exploration
• 📊 Resource Catalog — MCP resources for browsing available apps
• 🧪 43 Tests — Unit + integration test suite with Vitest
• ⚡ Fast Response — Optimized SQLite with FTS5 full-text search

🚀 Quick Start — Self-Hosting Options

Option A: npx (No Installation Needed!) 🚀

The fastest way to get started — no cloning, no building:

Prerequisites: Node.js installed on your system

# Run directly — no installation needed!
npx -y make-mcp-server

The package includes a pre-built database with all 200+ Make.com modules. Just add it to your MCP client config and go.

Claude Desktop config (claude_desktop_config.json):

Basic configuration (documentation tools only):

{
  "mcpServers": {
    "make-mcp-server": {
      "command": "npx",
      "args": ["-y", "make-mcp-server"],
      "env": {
        "LOG_LEVEL": "error"
      }
    }
  }
}

Full configuration (with Make.com deployment):

{
  "mcpServers": {
    "make-mcp-server": {
      "command": "npx",
      "args": ["-y", "make-mcp-server"],
      "env": {
        "LOG_LEVEL": "error",
        "MAKE_API_KEY": "your_api_key_here",
        "MAKE_TEAM_ID": "your_team_id",
        "MAKE_API_URL": "https://eu1.make.com/api/v2"
      }
    }
  }
}

Note: npx will download and cache the latest version automatically. The package includes a pre-built database with all Make.com module information — no setup required.

Option B: Docker (Isolated & Reproducible) 🐳

Prerequisites: Docker installed on your system

# Build the Docker image
docker build -t make-mcp-server .

# Test it works
echo '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}},"id":1}' | docker run -i --rm make-mcp-server

Claude Desktop config:

Basic configuration (documentation tools only):

{
  "mcpServers": {
    "make-mcp-server": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--init",
        "-e", "LOG_LEVEL=error",
        "make-mcp-server"
      ]
    }
  }
}

Full configuration (with Make.com deployment):

{
  "mcpServers": {
    "make-mcp-server": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--init",
        "-e", "LOG_LEVEL=error",
        "-e", "MAKE_API_KEY=your_api_key_here",
        "-e", "MAKE_TEAM_ID=your_team_id",
        "-e", "MAKE_API_URL=https://eu1.make.com/api/v2",
        "make-mcp-server"
      ]
    }
  }
}

Important: The -i flag is required for MCP stdio communication.

Option C: Local Installation (For Development) 🛠️

Prerequisites: Node.js and Git

# 1. Clone and install
git clone https://github.com/danishashko/make-mcp.git
cd make-mcp
npm install

# 2. Build
npm run build

# 3. Populate the module database (already done if using npm package)
npm run scrape:prod

# 4. Test it works
npm start

Claude Desktop config:

{
  "mcpServers": {
    "make-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/make-mcp/dist/mcp/server.js"],
      "env": {
        "LOG_LEVEL": "error",
        "MAKE_API_KEY": "your_api_key_here",
        "MAKE_TEAM_ID": "your_team_id"
      }
    }
  }
}

Note: The Make.com API credentials are optional. Without them, you'll have access to all documentation, search, and validation tools. With them, you'll additionally get scenario deployment capabilities.

Configuration File Locations

Restart Claude Desktop after updating configuration.

💻 Connect Your IDE

make-mcp-server works with any MCP-compatible client:

• Claude Desktop — See configurations above
• VS Code (GitHub Copilot) — Add to .vscode/mcp.json
• Cursor — Add to MCP settings
• Claude Code — Use claude mcp add command
• Windsurf — Add to MCP configuration

Usage

Then ask your AI assistant things like:

"Create a Make scenario that watches a Slack channel for new messages and logs them to a Google Sheet"

"What modules does Make have for sending emails?"

"Validate this scenario blueprint..."

Tip: The AI will automatically call tools_documentation first to understand how to use the server effectively.

Available Tools

Auto-Healing

The create_scenario tool automatically fixes common issues in LLM-generated blueprints:

Tip: Do NOT hardcode "version": 1 on modules. Some apps (e.g., HTTP) are on v4+ and specifying the wrong version causes "Module not found" errors.

MCP Prompts

MCP Resources

CLI Usage

make-mcp-server              # Start the MCP server (stdio transport)
make-mcp-server --scrape     # Populate/refresh the module database
make-mcp-server --version    # Print version
make-mcp-server --help       # Show help

Environment Variables

Development

npm run build         # Compile TypeScript + copy schema + add shebang
npm run build:tsc     # TypeScript only (no packaging)
npm run start:dev     # Start with tsx (no build needed)
npm run dev           # Start with file watching
npm run scrape        # Populate DB with tsx (dev)
npm run scrape:prod   # Populate DB from compiled JS
npm run smoke:compat  # One-command account compatibility + validation smoke check
npm test              # Run all 43 tests
npm run test:watch    # Run tests in watch mode

Publishing to npm