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クライアント。

ワンクリックデプロイ

デプロイ後、Cloudflareダッシュボード（Workers > あなたのワーカー > 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内のシークレットは、偶然の発見を防ぎます。完全な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 環境変数で公開するツールを制限できます:

カスタム例:

MOTION_MCP_TOOLS=custom:motion_tasks,motion_projects,motion_search npx motionmcp

ツールリファレンス

motion_tasks

操作: create, list, list_all_uncompleted, get, update, delete, move, unassign

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

list_all_uncompleted は1回の呼び出しですべてのワークスペースを対象とし（workspaceId/workspaceName は無視されます）、dueDate と priority フィルターを尊重するため、「すべてのワークスペースで今週の期限は？」という質問に直接答えます。list では、dueDate は当日以前を含む包括的な境界で、期限切れのタスクも含まれます（したがって dueDate: "today" は「今日の期限は？」に答えます）。また、completedAfter / completedBefore はアカウントのタイムゾーンでの完了日で制限され、「今週何を完了したか？」に答えます。日付はMotionアカウントのタイムゾーンで解釈され、リスト応答の先頭にはそのタイムゾーンと今日のローカル日付を示すヘッダーが付きます。

{
  "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

ユーザーのスケジュールを取得し、各日の勤務時間（1日ごとの開始-終了）とタイムゾーンを表示します。これらは繰り返しの勤務時間テンプレートのみであり、実際のカレンダーイベントや会議を公開するものではないため、それだけでは真の空き状況を表示できません。タスクの scheduledStart/scheduledEnd と組み合わせて、Motionが自動予約した内容を確認してください。

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（list）を使用してIDを検証してください

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

ライセンス

Apache-2.0 License

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