Skip to main content
Glama
Sign In
deenesjakoruzh
Motion MCP Server

Motion MCP Server

by casenterprises
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

NPM Version License

Motion MCP Server

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

预览

点击上方图片查看高清大图

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）

适用于移动端和 Web 客户端 — Claude 移动端/Web、ChatGPT 移动端/Web，或任何 HTTP MCP 客户端。

一键部署

Deploy to Cloudflare Workers

部署完成后，在 Cloudflare 仪表板中设置你的密钥（Workers > your 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 环境变量限制所暴露的工具：

级别

工具数

说明

minimal

3

仅限任务、项目、工作区

essential

7

增加用户、搜索、评论、日程

complete（默认）

10

完整 API 权限，包括自定义字段、重复任务、状态

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 项目。工作区和项目名称会自动匹配，如果未指定，服务器默认使用你的“个人”工作区。

{"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（list）和 motion_projects（list）验证 ID

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

许可证

Apache-2.0 License

如需了解更多信息，请参阅 Motion UI 文档 或 Model Context Protocol 文档。

This server cannot be deployed

Pay for results, not tokens.Fund a bounty. Let AI agents compete and collaborate to solve your problems.agentbounties.appAd

Resources

Related MCP Connectors

Related MCP Servers

Appeared in Searches