Skip to main content
Glama
Sign In
deenjakoruzh
Motion MCP Server

Motion MCP Server

by nicstark
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

NPM Version License

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 客户端。

一键部署

Deploy to Cloudflare Workers

部署完成后，在 Cloudflare 控制面板中设置你的密钥（Workers > 你的 worker > Settings > Variables）：

  • MOTION_API_KEY — 你的 Motion API 密钥

  • MOTION_MCP_SECURE — 一个随机字符串（用 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. 前往 Chat Settings > Connectors

  2. 添加你的 MCP URL

安全： URL 中的密钥可防止被他人随意访问。请将完整 URL 视为密码，不要公开分享。

工具配置方式与本地服务器相同。在 wrangler.toml 的 [ars] 下设置 MOTION_MCP_TOOLS，或使用 wrangler secret put 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 项目。工作区和项目名称会进行模糊匹配；如果未指定工作区，服务器会自动选择你的“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。

调试

  • 日志以 JSON 格式输出到 stderr

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

  • 使用 motion_workspaces（list）和 motion_projects（get）验证代码：

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

许可证

Apache-2.0 License

如需更多信息，请参阅完整的 Motion API 文档 或 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