Motion MCP (Devondragon)


运动MCP服务器

运动 是一款AI驱动的日历和任务管理应用程序，可自动安排您的工作。此MCP服务器通过 模型上下文协议，因此您可以通过自然对话管理任务、搜索项目、检查日程安排等。它适用于台式机、网络和移动设备。

预览

*点击上图查看全尺寸*

入门指南

先决条件： Node.js 18+和 运动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 mobile/web、ChatGPT mobile/web或任何HTTP MCP客户端。

一键部署


部署后，在Cloudflare仪表板中设置您的机密（Workers>your worker>Settings>Variables）：

• MOTION_API_KEY -您的运动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

来自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开发，请参阅 开发商.md.

API密钥

服务器从 MOTION_API_KEY 环境变量。

内联（npx）：

MOTION_API_KEY=your-key npx motionmcp

.env file（通过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, get, update, delete, move, unassign

任务管理的主要工具。支持所有运动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"]
}

运动_项目

操作： create, list, get

管理运动项目。工作区和项目名称是模糊匹配的，如果没有指定，服务器会自动选择您的“个人”工作区。

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

运动工作空间

操作： list, get

列出并检查工作空间。

motion_users

操作： list, current

列出工作区中的用户或获取当前经过身份验证的用户。

运动搜索

操作： content

通过查询在工作区中搜索任务和项目。

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

动议_意见

操作： list, create

阅读任务和项目并添加评论。

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

运动时间表

操作： 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_status

操作： 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"
      }
    }
  }
}

请参阅中的完整开发人员设置 开发商.md.

调试

• 日志输出到 stderr JSON格式
• 检查是否缺少密钥、工作区/项目名称和权限
• 使用 motion_workspaces （列表）和 motion_projects （列表）验证ID

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

许可证

Apache-2.0许可证

______________________________________________________________________

有关更多信息，请参阅完整 运动API文档 或 模型上下文协议文档.