Motion MCP Server

Motionは、AIを活用したカレンダー・タスク管理アプリで、あなたの作業を自動的にスケジュールします。このMCPサーバーは、Model Context Protocolを介してMotionのAPIとClaudeやChatGPTなどのLLMを橋渡しするため、タスクの管理、プロジェクトの検索、スケジュールの確認などがすべて自然な会話でできるようになります。デスクトップ、ウェブ、モバイルに対応しています。

プレビュー

href="sample.png">

上の画像をクリックするとフルサイズで表示されます

Related MCP server: motion-mcp-server

はじめに

前提条件: Node.js 20+とMotion API keyが必要です。

ローカルセットアップ (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 mobile/web、ChatGPT mobile/web、または任意のHTTP MCPクライアント。

ワンクリックデプロイ

デプロイ完了後、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 > 設定 > コネクターへ

2. MCP URLを追加する

3. サーバーはClaudeモバイルアプリに自動同期されます

ChatGPTからの接続

1. ChatGPTの設定 > コネクターへ

2. MCP URLを追加する

セキュリティ: パスに含まれるシークレットは偶発的な発見を防ぎます。URL全体をパスワードと同じように扱い、公開しないでください。

ツール構成はローカルサーバーと同じです。wrangler.tomlの[was]に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

操作: create、list、get、update、delete、move、unassign

タスク管理の主要なツールです。name、description、priority、dueDate、duration、labels、assigneeId、autoScheduledなど、Motion APIのすべてのパラメーターをサポートします。ワークスプレースとプロジェクトは名前で参照でき、サーバーが自動的に解決します。

{
  "operation": "create",
  "name": "Complete API integration",
  "workspaceName": "Development",
  "projectName": "Release Cycle Q2",
  "dueDate": "2025-06-15T09:00:00Z",
  "priority": "HIGH",
  "labels": ["api", "release"]
}

motion

操作: create、list、get

Motionのプロジェクトを管理します。ワークスペース名とプロジェクト名はあいまい一致され、指定がない場合はサーバーが自動的に"Personal"ワークスプレースを選択します。

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

motion

操作: list、get

ワークスペースの一覧と詳細を表示します。

motion

操作: list、current

ワークスペース内のユーザーを一覧表示するか、現在認証されているユーザーを取得します。

motion

操作: content

クエリを使つのワークスペース内でタスクとプロジェクトを検索します。

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

motion

操作: steplist、create`

タスクやプロジェクトのコメントを読み取ったり、追加したりします。

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

motion

操作: list

ユーザーのスケジュールとタイムゾーンを取得します。競合検出を備えた優先順位のスケジュールリングと、ステータス・優先度・プロジェクト別の作業負荷の内訳をサポートします。

motion

操作: list、create、delete、add_to_project、remove_from_project、add_task、remove_task

ワークスペース、プロジェクト、タスク間でカスタフィールドを定義・管理します。

{
  "operation": "create",
  "name": "Sprint",
  "type": "DROPDOWN",
  "options": ["Sprint 1", "Sprint 2", "Sprint 3"],
  "workspaceName": "Development"
}

motion

操作: list、create、delete

繰り返すタスクのテンプレートを管理します。

{
  "operation": "create",
  "name": "Weekly Team Standup",
  "recurrence": "WEEKLY",
  "projectName": "Team Meetings",
  "daysOfWeek": ["MONDAY", "WEDNESDAY", "FRIDAY"],
  "duration": 30
}

motion

操作: 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]で ./DEVELOPER.md)を参照してください。

デバッグ

• ログはJSON形式でstderrに出力されます

• 欠落したキー、ワークスペース/プロジェクト名、権限を確認

• 下さいIDートを検証するには、motionm_workspace（list）とmotion_projects（list）を使用

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

ライセンス

Apache-2.0ライセンス

詳細はMotion APIドキュメントまたはModel Context Protocolドキュメントを参照してください。