SkillAgentSearch skills...

make-mcp

Unofficial MCP server for Make.com build, validate & deploy automation scenarios with AI. 200+ modules, auto-healing blueprints, router support. Community project, not affiliated with Make.com.

Install / Use

claude mcp add danishashko -- npx -y github:danishashko/make-mcp

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

80/100

Category

Automation

Supported Platforms

Claude Code
Claude Desktop
Cursor
GitHub Copilot

Our assessment of make-mcp

make-mcp scores 80/100 on our quality scale, 2407th of 2,771 Automation skills we index.

Its MCP Server is 13 KB long, well organised into 33 sections with 14 code examples: a thorough specification that gives an agent plenty to work with.

It has 10 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
4/20
Freshness
11/15

Maintenance, license and trust

  • The repository was last updated about 9 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 91/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

make-mcp compared with similar skills

All 4 of these similar skills score higher than make-mcp; compare them before choosing.

SkillScoreStarsUpdatedFormat
make-mcp (this skill)by danishashko80109mo agoMCP Server
claude-memby thedotmack100118.5ktodayCLAUDE.md
Agent-Reachby Panniantong100113.3k12d agoCLAUDE.md
hyperframesby heygen-com10087.1ktodayCLAUDE.md
rufloby ruvnet10082.1ktodayCLAUDE.md

Frequently asked questions

How do I install make-mcp?
Run claude mcp add danishashko -- npx -y github:danishashko/make-mcp. The install tabs above show the steps for each supported agent.
Which AI agents does make-mcp work with?
It is written for Claude Code, Claude Desktop, Cursor and GitHub Copilot, as a MCP Server file. Other agents that read the same format can often use it too.
Is make-mcp safe to use?
It is MIT-licensed and scores 91/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is make-mcp still maintained?
The repository was last updated about 9 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.

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

npm version License: MIT

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

| Platform | Path | |----------|------| | macOS | ~/Library/Application Support/Claude/claude_desktop_config.json | | Windows | %APPDATA%\Claude\claude_desktop_config.json | | Linux | ~/.config/Claude/claude_desktop_config.json |

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

| Tool | Description | |------|-------------| | tools_documentation | START HERE — Returns comprehensive documentation for all tools, prompts, and resources | | search_modules | Full-text search across 200+ Make.com modules | | get_module | Get detailed module info with parameters and docs | | check_account_compatibility | Check if modules are available in your current Make account/region (with suggestions) | | validate_scenario | Validate a scenario blueprint before deployment | | create_scenario | Deploy a scenario to Make.com via API | | search_templates | Search reusable scenario templates | | list_apps | List all apps with module counts |

Auto-Healing

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

| Issue | Auto-Fix | |-------|----------| | Missing metadata section | Injects full metadata with version, scenario config, and designer | | Missing metadata.designer on modules | Adds { x: 0, y: 0 } coordinates | | Router filter in route objects | Strips unsupported filter property (configure filters in Make.com UI) | | Missing version on modules | Left unset — Make.com auto-resolves the latest installed version | | Catalog mismatch (IM007, module not available) | Checks live modules in your account/region, auto-remaps close matches, retries deploy once |

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

| Prompt | Description | |--------|-------------| | build_scenario | Guided workflow for creating a Make.com scenario from a natural language description | | explain_module | Get a detailed explanation of any Make.com module with usage examples |

MCP Resources

| Resource URI | Description | |-------------|-------------| | make://apps | List of all available apps with module counts |

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

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | MAKE_API_KEY | For deployment | — | Make.com API key | | MAKE_API_URL | No | https://eu1.make.com/api/v2 | Make.com API base URL | | MAKE_TEAM_ID | For deployment | — | Default team ID for scenario deployment | | DATABASE_PATH | No | <package>/data/make-modules.db | SQLite database file path | | LOG_LEVEL | No | info | Logging level: debug, info, warn, error, silent | | MAKE_MODULE_CACHE_TTL_MS | No | 300000 | Cache TTL for live module catalog checks (milliseconds) |

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

npm run prepublishOnly   # Build + populate DB + verify (runs automatically on npm publish)
npm publish              # Publish to npm registry

Testing

The test suite includes 43 tests across 3 files:

  • Database tests (14 tests) — Insert, search, template operations, FTS5 queries
  • Logger tests (7 tests) — Stderr-only output, log levels, data serialization
  • Server integration tests (22 tests) — Full MCP protocol compliance via SDK client
npm test

Fast Verification (2-3 minutes)

Use this when you just changed validation/deploy logic and want confidence quickly:

# 1) Fast regression check
npm test

# 2) One-command smoke check (compatibility + validation)
npm run smoke:compat

# 3) (Optional) Manual MCP exploration
npm run start:dev

Then in your MCP client (Claude/Cursor/Copilot), run this sequence:

  1. check_account_compatibility with a known module, e.g. gateway:CustomWebHook
  2. validate_scenario with your blueprint
  3. create_scenario only if compatibility is good

If step 1 reports incompatible modules, use the suggested replacement IDs before deploying.

Architecture

src/
├── mcp/
│   └── server.ts          # MCP server with tools, prompts, resources
├── database/
│   ├── schema.sql         # SQLite + FTS5 schema
│   └── db.ts              # Database access layer (npx-safe path resolution)
├── scrapers/
│   └── scrape-modules.ts  # Module data population (224 modules)
└── utils/
    └── logger.ts          # Structured stderr-only logger
bin/
├── make-mcp.js            # CLI entry point (npx, --help, --version, --scrape)
└── postinstall.js         # Post-install verification
scripts/
├── build.js               # Build: tsc + copy schema + add shebang
├── prepublish.js          # Publish prep: build + populate DB + verify
└── smoke-compat.js        # Fast local smoke test for module compatibility + validation
data/
└── make-modules.db        # Pre-built SQLite database (bundled in npm package)
tests/
├── database.test.ts       # Da

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars10
CategoryAutomation
Updated9mo ago
Forks1

Languages

TypeScript

Trust signals

91/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 low1 info