DM

devondragon/motionmcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

30 stars 22 forks 质量 83 趋势 31Apache-2.0

MCP服务器用于运动任务管理系统

概览

Motion是一款由AI驱动的日历和任务管理应用,能够自动安排你的工作。这个MCP服务器通过Model Context Protocol连接Motion的API,连接Claude和ChatGPT等大型语言模型,让你可以通过自然对话管理任务、搜索项目、检查日程等。它支持桌面、网页和移动端。 对于桌面MCP客户端——Claude Desktop、Claude Code、Cursor等。 NPX始终运行最新发布的版本——无需安装。 对于移动和网页客户端——Claude 移动/网页、ChatGPT 移动/网页,或任何 HTTP MCP 客户端。 部署后,在Cloudflare仪表盘中设置秘密(Workers > your worker >设置>变量):- MOTION_API_KEY — 你的Motion API密钥- MOTION_MCP_SECRET — 一个随机字符串(用openssl rand -hex 16生成) 用那个地址。

概述(AI 翻译)

Motion是一款由AI驱动的日历和任务管理应用,能够自动安排你的工作。这个MCP服务器通过Model Context Protocol连接Motion的API,连接Claude和ChatGPT等大型语言模型,让你可以通过自然对话管理任务、搜索项目、检查日程等。它支持桌面、网页和移动端。

预览

点击上方图片查看全尺寸

开始

前提条件: Node.js 20+ 和 Motion API 密钥。

本地设置(NPX)

对于桌面MCP客户端——Claude Desktop、Claude Code、Cursor等。

在你的claude_desktop_config.json中添加:

命令行测试:

提示: npx 始终运行最新发布版本——无需安装。

远程设置(Cloudflare Workers)

对于移动和网页客户端——Claude 移动/网页、ChatGPT 移动/网页,或任何 HTTP MCP 客户端。

一键部署

部署后,在Cloudflare仪表盘中设置你的秘密(Workers>你的Worker,>设置>变量):

  • MOTION_API_KEY — 您的 Motion API 密钥
  • MOTION_MCP_SECRET — 随机字符串(由openssl rand -hex 16生成)

手动部署

您的MCP网址将是:

用那个地址。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Motion MCP Server

Motion is an AI-powered calendar and task management app that auto-schedules your work. This MCP server bridges Motion’s API with LLMs like Claude and ChatGPT via the Model Context Protocol, so you can manage tasks, search projects, check your schedule, and more — all through natural conversation. It works on desktop, web, and mobile.

Preview

Click the image above to view full size

Getting Started

Prerequisites: Node.js 20+ and a Motion API key.

Local Setup (npx)

For desktop MCP clients — Claude Desktop, Claude Code, Cursor, and similar.

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "motion": {
      "command": "npx",
      "args": ["motionmcp"],
      "env": {
        "MOTION_API_KEY": "your_api_key"
      }
    }
  }
}

Test from the command line:

MOTION_API_KEY=your_api_key npx motionmcp

Tip: npx always runs the latest published version — no install needed.

Remote Setup (Cloudflare Workers)

For mobile and web clients — Claude mobile/web, ChatGPT mobile/web, or any HTTP MCP client.

One-click deploy

After deploy, set your secrets in the Cloudflare dashboard (Workers > your worker > Settings > Variables):

  • MOTION_API_KEY — your Motion API key
  • MOTION_MCP_SECRET — a random string (generate with openssl rand -hex 16)

Manual deploy

# 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

Your MCP URL will be:

https://motion-mcp-server.YOUR_SUBDOMAIN.workers.dev/mcp/YOUR_SECRET

Use exactly that address. The secret goes at the end of the path and nothing follows it. The server speaks MCP Streamable HTTP on that single endpoint; do not append /sse or any other sub-path.

Clients that can send headers can keep the secret out of the URL instead: point them at https://motion-mcp-server.YOUR_SUBDOMAIN.workers.dev/mcp and send Authorization: Bearer YOUR_SECRET.

Connecting from Claude

  1. Go to claude.ai > Settings > Connectors
  2. Add your MCP URL
  3. The server syncs automatically to the Claude mobile app

For Claude Code, use the Streamable HTTP transport:

claude mcp add --transport http motion https://motion-mcp-server.YOUR_SUBDOMAIN.workers.dev/mcp --header "Authorization: Bearer YOUR_SECRET"
在 GitHub 查看完整 README

安装

npx motionmcp
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "motion": { "command": "npx", "args": ["motionmcp"], "env": { "MOTION_API_KEY": "your_api_key" } } } }