Motion MCP Server

Motion MCP サーバー

Motion は、AI を活用したカレンダーおよびタスク管理アプリで、作業を自動的にスケジュールしてくれます。この MCP サーバーは、Motion の API と Claude や ChatGPT などの LLM を Model Context Protocol 経由で橋渡しするため、自然な会話を通じてタスクの管理、プロジェクトの検索、スケジュールの確認などを行えます。デスクトップ、Web、モバイルで動作します。

プレビュー

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

はじめに

前提条件: 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)

モバイルおよび Web クライアント — Claude モバイル/Web、ChatGPT モバイル/Web、その他の HTTP MCP クライアント向けです。

ワンクリックデプロイ

デプロイ後、Cloudflare ダッシュボード (Workers > 対象の 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

このアドレスをそのまま使用してください。シークレットはパスの末尾にあり、その後には何も続きません。サーバーはその単一のエンドポイントで MCP Streamable HTTP を提供します。/sse やその他のサブパスを追加しないでください。

ヘッダーを送信できるクライアントでは、代わりにシークレットを URL から除外できます。その場合は https://motion-mcp-server.YOUR_SUBDOMAIN.workers.dev/mcp を指定し、Authorization: Bearer YOUR_SECRET を送信します。

Claude からの接続

1. claude.ai > Settings > Connectors に移動します
2. MCP URL を追加します
3. サーバーは Claude モバイルアプリに自動的に同期されます

Claude Code の場合は、Streamable HTTP トランスポートを使用します:

claude mcp add --transport http motion https://motion-mcp-server.YOUR_SUBDOMAIN.workers.dev/mcp --header "Authorization: Bearer YOUR_SECRET"

Claude Desktop では、同じ URL をタイプ http のリモートサーバーとして追加します (sse ではありません)。

ChatGPT からの接続

1. ChatGPT Settings > Connectors に移動します
2. MCP URL を追加します

セキュリティ: URL 内のシークレットは、安易な発見を防ぐためのものです。URL 全体をパスワードのように扱い、公開しないでください。

トランスポート: 提供されるのは Streamable HTTP のみです。旧来の HTTP+SSE トランスポート (GET ストリームと /message エンドポイント) は、ステートレスサーバーへの移行に伴い廃止されました。トランスポートタイプ sse で設定されたクライアントは http に切り替える必要があります。

ツールの設定はローカルサーバーと同じように機能します。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 環境変数で公開するツールを絞り込めます。

レベル	ツール数	説明
minimal	3	タスク、プロジェクト、ワークスペースのみ
essential	8	ユーザー、検索、コメント、スケジュール、ステータスを追加
complete（デフォルト）	10	カスタムフィールドと繰り返しタスクを含む完全な API アクセス
custom	可変	必要なツールを正確に選択

カスタムの例:

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

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

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 ドキュメント を参照してください。