Motion MCP Server

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

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

Предварительные требования: 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"
      }
    }
  }
}

Проверьте из командной строки:

MOTION_API_KEY=your_api_key npx motionmcp

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

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

Для мобильных и веб-клиентов — Claude mobile/web, ChatGPT mobile/web или любой HTTP MCP-клиент.

Развёртывание в один клик

После развёртывания задайте секреты в панели Cloudflare (Workers > ваш worker > Settings > Variables):

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

• MOTION_MCP_SECRET — случайная строка (сгенерируйте с помощью opnssl rand -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

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

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

1. Перейдите на claude.ai > Settings > Connectors

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

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

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

1. Перейдите в Settings ChatGPT > Connectors

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

Безопасность: секрет в URL предотвращает случайное обнаружение. Относитесь к полному URL как к паролю — не публикуйте его публично.

Настройка инструментов работает так же, как и сервере локального сервера. Укажите MOTION_MCP_TOLS0 в wrangler.toml в разделе [var], или переопределите с помощью wrangler secret put MOTION_MCP_TOOLS.

Инструкции для длалокального развития Worker см. в DEVELOPER.md.

Ключ API

Сервер читает ваш ключ Motion API из переменной окружения MOTION_API_KEY.

При вставке в команду (npx):

MOTION_API_KEY=your-key npx motionmcp

Файл .env (при запуске из исходного кода через npm):

MOTION_API_KEY=your-key

При использовании npx используйте инлайн‑переменную окружения, так как npx не читает локальный файл .env`.

Конфигурация инструментов

Все 10 инструментов включены по умолчанию. Если вы запускаете несколько MCP‑сервереров и хотите сократить шум при выборе инструментов, можно ограничить набор включенных инструментов через переменную окружения MOTION_CP_TOOLS:

Пример (custom):

MOTION_MCP_TOOLS=custom:motion_tasks,motion_projects,motion_search npx motionmcp

Справочник инструментов

motion_tasks

Операции: create, list, get, update, delete, move, unassign

Основной инструмент для управления задачами. Поддерживает все параметры Motion API, включащие name, description, priority, dueDate, duration, labels, assigneeId и autoScheduled. Можно ссылаться на рабочие пространства и проекты по имени — сервер подставит их автоматически.

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

motion_projects

Операции: create, list, get

Управляет проектами Motion. Имена рабочих пространства и проекта сопоставляются нечетко, а если пространства не задано, сервер автоматически выбирает workspace «Personal».

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

motion_workspaces

Операции: list, get

Получение списка рабочих пространств и просмотр их параметров.

motion_users

Операции: list, current

Получение списка пользователей рабочего пространства или информации о текужем авторизованном пользователе.

motion_search

Операции: content

Поиск задач и проектов по запросу в рабочем пространстве.

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

motion_comments

Операции: list, create

Чтение и добавление комментариев к задачам и проектам.

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

motion_schedules

Операции: list

Получение расписаний пользователей и времённых зон. Поддерживается планирование по приоритетным сценариям с обработкой конфликтов и разбивкой загрузки по статусу, приоритету и проекту.

motion_custom_fields

Операции: list, create, delete, add_to_project, remove_from_project, add_to_task, remove_from_task

Определение и управление настраиваемыми полями в рабочих пространствах, проектах и задачах.

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

motion_recurring_tasks

Операции: list, create, delete

Управление шаблонами повторяющихся задач.

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

motion_statuses

Операции: list

Получение списка доступных статусов для рабочего пространства.

Расширенная конфигурация

Минимальная настройка (только 3 инструмента):

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

Выбор пользовательских инструментов:

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

Использование локального окружения (npm):

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

Полную информацию для разработчиков см. в DEVELOPER.md.

Отладка

• Логи выводятся в stderr в JSON‑формате

• Проверяйте отсутствие необходимых ключей, имена рабочих пространств/проектов и разрешения

• Используйте motion_workspaces (список) и motion_projects (список), чтобы проверить корректные ID

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

Лицензия

Apache-2.0 License

Для получения дополнительной информации обратитесь к полной документации Motion API или документации Model Context Protocol.