Motion MCP Server

Motion 是一款由 AI 驱动的日历和任务管理应用，可自动安排你的工作。此 MCP 服务器通过 Model Context Protocol 将 Motion 的 API 与 Claude 和 ChatGPT 等 LLM 连接起来，因此你可以通过自然对话管理任务、搜索项目、查看日程等。它适用于桌面端、网页端和移动端。

预览

点击上方图片查看完整尺寸

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 移动端/网页、ChatGPT 移动端/网页，或任何 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 > Settings > Connectors

2. 添加你的 MCP URL

3. 服务器会自动同步到 Claude 移动应用

从 ChatGPT 连接

1. 前往 ChatGPT Settings > Connectors

2. 添加你的 MCP URL

安全： URL 中的密钥可防止随意发现。请将完整 URL 视为密码——不要公开分享。

工具配置与本地服务器相同。在 wrangler.toml 的 [vars] 下设置 MOTION_MCP_TOOLS，或通过 wrangler secret put MOTION_MCP_TOOLS 覆盖。

有关本地 Worker 开发，请参阅 DEVELOPER.md。

API 密钥

服务器从 MOTION_API_KEY 环境变量中读取你的 Motion API 密钥。

内联（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。

调试

• 日志以 JSON 格式输出到 stderr

• 检查缺失的密钥、工作区/项目名称和权限

• 使用 motion_workspaces（list）和 motion_projects（list）验证 ID

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

许可证

Apache-2.0 许可证

更多信息，请参阅完整的 Motion API 文档 或 Model Context Protocol 文档。