Motion MCP Server

Motion — это приложение для управления календарём и задачами на основе ИИ, которое автоматически планирует вашу работу. Этот MCP-сервер связывает API Motion с LLM, такими как Claude и 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"
      }
    }
  }
}

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

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

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

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

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

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

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

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

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

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

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

Конфигурация инструментов работает так же, как и для локального сервера. Установите MOTION_MCP_TOOLS в wrangler.toml в разделе [vars] или переопределите с помощью 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_MCP_TOOLS:

Пример настройки:

MOTION_MCP_TOOLS=custom:motion_tasks,motion_projects,motion_search npx motionmcp

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

motion_tasks

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

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

list_all_uncompleted охватывает все рабочие пространства одним вызовом (он игнорирует workspaceId/workspaceName) и учитывает фильтры dueDate и priority, поэтому запрос «что запланировано на эту неделю во всех моих рабочих пространствах?» решается напрямую. При list параметр dueDate является включающей границей «на или до дня», которая включает просроченные задачи (так что dueDate: "today" отвечает на вопрос «что запланировано на сегодня?»), а completedAfter / completedBefore ограничивают по дате завершения в часовом поясе вашей учётной записи для вопроса «что я сделал на этой неделе?». Даты интерпретируются в часовом поясе вашей учётной записи Motion, и ответы списка начинаются с заголовка, указывающего этот пояс и сегодняшнюю локальную дату.

{
  "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. Имена рабочих пространств и проектов сопоставляются нечётко, и сервер автоматически выбирает ваше рабочее пространство «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

Получение расписаний пользователей с указанием рабочих часов каждого дня (начало-конец) и часовых поясов. Это только повторяющиеся шаблоны рабочего времени — они не показывают фактические события календаря или встречи, поэтому сами по себе не могут дать полную картину занятости; комбинируйте их с scheduledStart/scheduledEnd задач, чтобы увидеть, что Motion забронировал автоматически.

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 (list) и motion_projects (list) для проверки ID

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

Лицензия

Apache-2.0 License

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