megaplan-mcp

MCP server for Megaplan project management. Tasks, deals, projects, employees, comments via API v3.

| Tool | Description | |------|------------| | get_tasks | List tasks with filters by status, responsible, search | | create_task | Create a task with name, description, deadline | | get_deals | List deals with filters | | create_deal | Create a deal with pipeline, amount, contact | | get_projects | List projects with filters | | get_employees | List employees with search, department filter | | get_comments | List comments on task/deal/project | | create_comment | Add a comment to task/deal/project |

| Skill | Description | |-------|------------| | my-tasks-today | "Мои задачи на сегодня" — active tasks sorted by urgency | | create-deal-wizard | "Создай сделку" — guided deal creation |

1. In Megaplan, go to Settings > Integration > API
2. Generate an access token

Use your Megaplan login credentials (email + password).

{
  "mcpServers": {
    "megaplan": {
      "command": "npx",
      "args": ["-y", "@theyahia/megaplan-mcp"],
      "env": {
        "MEGAPLAN_DOMAIN": "yourcompany",
        "MEGAPLAN_TOKEN": "your-access-token"
      }
    }
  }
}

Or with login/password:

{
  "mcpServers": {
    "megaplan": {
      "command": "npx",
      "args": ["-y", "@theyahia/megaplan-mcp"],
      "env": {
        "MEGAPLAN_DOMAIN": "yourcompany",
        "MEGAPLAN_LOGIN": "user@example.com",
        "MEGAPLAN_PASSWORD": "your-password"
      }
    }
  }
}

Run with --http flag for HTTP-based transport (useful for remote/cloud deployments):

MEGAPLAN_DOMAIN=yourcompany MEGAPLAN_TOKEN=xxx npx @theyahia/megaplan-mcp --http
# Listening on http://localhost:3000/mcp

Custom port via PORT env var.

|