@theyahia/megaplan-mcp

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

Tools (8)

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

Skills (Prompts)

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

Setup

Option A: Access Token

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

Option B: Login + Password

Use your Megaplan login credentials (email + password).

Usage with Claude Desktop

{
  "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"
      }
    }
  }
}

Streamable HTTP Transport

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.

Environment Variables

Variable	Required	Description
`MEGAPLAN_DOMAIN`	Yes	Megaplan subdomain (e.g. `yourcompany`)
`MEGAPLAN_TOKEN`	One of	Bearer access token
`MEGAPLAN_LOGIN`	One of	Login email (if no token)
`MEGAPLAN_PASSWORD`	One of	Password (if no token)
`PORT`	No	HTTP port for `--http` mode (default: 3000)

Referral

Get 20-50% recurring commission by referring Megaplan:

Megaplan Partner Program
Sign up as a partner, get your referral link
Every client you bring = recurring revenue share

Development

npm install
npm run build
npm test
npm run dev          # stdio mode with tsx
npm run start:http   # HTTP mode

License

MIT

megaplan-mcp

Quick Install