@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