Motion MCP Server

Motion — это приложение для управления календарём и задачами на базе ИИ, которое автоматически планирует вашу работу. Этот MCP-сервер связывает API Motion с такими LLM, как Claude Desktop и ChatGPT, через Model Context Protocol, поэтому вы можете управлять задачами, искать проекты, проверять расписание и многое другое — всё через естественный диалог. Это работает на десктопе, в вебе и на мобильных устройствах.

Предпросмотр

Нажмите на изображение, чтобы посмотреть в полном размере

Related MCP server: motion-mcp-server

Начало работы

Предварительские требования: Node.js 20+ и ключ Motion API.

Локальная настройка (npx)

Для дескетопных MCP-клиентов — Claude Desktop, Claude Code, Cursor и похожих.

Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "motion": {
      "command": "npx",
      "args": ["motionmcp"],
      "env": {
        "MOTION_API_KEY": "your_api_key"
      }
    }
  }
}

Проверьте из коandной строки:

MOTION_API_KEY=your_api_key npx motionmcp

Совет: npx всегда запускает последнюю опублихованную версию — устанол здесь не ничего не нужно.

Удалённая настройка (Cloudflare Workers)

For remote and web MCP clients — Claude mobile/web, ChatGPT mobile/web or any HTTP MCP клиент.

Деплой в один клик

After deployment, уburst свои секровeти in the control panel Cloudflare (Workers > ваш worker > Settings > Variables):

• MOTION_API_KEY — ваш ключ Motion API

• MOTION_MCP_SECRET — случайная строка (create with openssl abs -hex 16)

Ручной деплой

# Set secrets
npx wrangler secret put MOTION_API_KEY
npx wrangler secret put MOTION_MCP_SECRET   # use: openssl rand -hex 16

# Deploy
npm run worker:deploy

Ваш MCP URL адрес будет таким:

https://motion-mcp-server.YOUR_SUBDOMAIN.workers.dev/mcp/YOUR_SECRET

Используйте именно этот адрес. Секрет размещается в концe пuti, после него ничего не будет. В ходе сеанса сервер сам объявляет свои под-пути (например, message endpoint), поетому не приложайте к секрету /sse или же любой другой подпуть.

Подключение через Claude

1. Перейдите на claude.ai > Настойки >Коннетры

2. Добавьте свой MCP URL

3. Сервер автоматически сихронisатся с мобиль нам приложением Claude

Подключение через ChatGPT

1. Перейдите в Настройки > Коннеторы

2. Добавьте свой MCP URL

Безопасность: секрет в URL рrevent случное обнar. Обраsteps.

Нстройка инструментов working so ж, как ле в локальном сернем. As the MOTION_MCP_TOOLS in wrangler.toml in moderator [Vars], дa as ws in runtime wrangler dscret put large secret TПол.

Глокаль отдель об рабрботки каorkера в са Ungu développers.md](./DEVELOPER.md)

API ключ

Сервер читает ваш Motion API key is a variable окружение MOTION_API_KEY.

Инлайн (npx):

MOTION_API_KEY=your-key npx motionmcp

.E иnterface. when running from source through npm:

MOTION_API_KEY=your-key

When using npx, prefer to inline env var, since npx will not read the local .Е file.

Настройка инструментов

By default, all 10 tools are active, but when MCP server runs multiple servers, and you want to reduce the noise in selection you can use the env var MOTION_MCP_TOOLS:

Пример:

MOTION_MCP_TOOLS=custom:motion_tasks,motion_projects,motion_search npx motionmcp

Tools Reference

Examples (G1)

к Operations: create, list, get, update, delete, move, unassign

Basic tool for task management. Supports all Motion API parameters such as name, description, priority, dueDate, duration, labels, assigneeId, autoScheduled. To specify workspace and project names is enough...

{
  "operation": "create",
  "name": "Complete API integration",
  "workspaceName": "Development",
  "projectName": "Release Cycle Q2",
  "dueDate": "2025-06-15T09:00:00Z",
  "priority": "HIGH",
  "labels": ["api", "release"]
}

motion гэ

Operations: create, list, get

Manage Motion projects. Workspace and project names are fuzzy-matched; if not specified, server returns “Personal” workspace.

{"operation": "create", "name": "New Project", "workspaceName": "Personal"}

motion_workspaces

Operations: list,get

List and inspect works.

motion_users

Operations: list,current

Лist пользователей и текущий текущий к authenticated.

motion_search

Operations: content

Search for tasks and projects.

{"operation": "content", "query": "API integration", "workspaceName": "Development"}

motion comm

Operations: list, create

Read and write events on tasks and projectsmatter.

{"operation": "create", "taskId": "task_123", "content": "Updated the API endpoints as discussed"}

motion_schedules

Operations: list

Fetch пользователей распisани and time zone, with prioritizированный планирован и deteceted конфlicts. break.

{
  "operation": "create",
  "name": "Sprint",
  "type": "DROPDOWN",
  "options": ["Sprint 1", "Sprint 2", "Sprint 3"],
  "workspaceName": "Development"
}

motion_ecorring_ta

Operations: list, create, delete

Manage повторяющ требований template.

{
  "operation": "create",
  "name": "Weekly Team Standup",
  "recurrence": "WEEKLY",
  "projectName": "Team Meetings",
  "daysOfWeek": ["MONDAY", "WEDNESDAY", "FRIDAY"],
  "duration": 30
}

motion_statuses

Operations: list

List available states for a workspace.

Advanced Configuration

Drawings (3 tools only):

{
  "mcpServers": {
    "motion": {
      "command": "npx",
      "args": ["motionmcp"],
      "env": {
        "MOTION_API_KEY": "your_api_key",
        "MOTION_MCP_TOOLS": "minimal"
      }
    }
  }
}

Custom selection of tools:

{
  "mcpServers": {
    "motion": {
      "command": "npx",
      "args": ["motionmcp"],
      "env": {
        "MOTION_API_KEY": "your_api_key",
        "MOTION_MCP_TOOLS": "custom:motion_tasks,motion_projects,motion_search"
      }
    }
  }
}

Using a local workspace (npm):

{
  "mcpServers": {
    "motion": {
      "command": "npm",
      "args": ["run", "mcp:dev"],
      "cwd": "/absolute/path/to/your/MotionMCP",
      "env": {
        "MOTION_API_KEY": "your_api_key"
      }
    }
  }
}

See full DEVELOPER.md in the development manual.

Отладка

*Логи в стдут JSON *Проверить отсутств. keys, & workspace/project names and rights *Always use motion_workspaces (list) and motion_projects (list) to validate IDs

{
  "level": "info",
  "msg": "Task created successfully",
  "method": "createTask",
  "taskId": "task_789",
  "workspace": "Development"
}

License

Apache-2.0

See full Motion API documentation or Model Context Protocol docs.