Taskpile.app

Taskpile MCP

Taskpile の Model Context Protocol サーバーに関する公開ドキュメントです。

何も忘れず、今日に集中しましょう。 Taskpile は、「まず何でも放り込む、あとで整理する」という2つの動詞を軸にした、個人向けタスクトラッカーです。Claude、ChatGPT、またはMCP互換クライアントから、あるいは taskpile.app のアプリから、思いついたことをその場で何でも記録できます。毎日2分のレビューで、積み上がったタスクを短い「今日」のリストに整理し、残りは順番が来るまで保留にします。

Taskpile は Claude コネクターディレクトリに掲載されています。

• アプリ：https://taskpile.app
• MCP エンドポイント：https://taskpile.app/api/mcp
• トランスポート：Streamable HTTP（JSON-RPC 2.0）
• 対応プロトコルバージョン：2025-11-25、2025-06-18、2025-03-26、2024-11-05

このリポジトリに含まれるのは、MCP 統合に関する公開ドキュメントのみです。Taskpile アプリ自体はホスト型の商用製品です。ソースコードはここにはありませんが、クライアントの接続と MCP ツールの利用に必要な情報はすべて揃っています。

接続

MCP 互換クライアントであれば、上記の URL を指定して接続できます。認証には、Dynamic Client Registration と PKCE を使用する OAuth 2.1 を採用しています。クライアントがこの処理を自動で行うため、ユーザーはプロンプトが表示されたときにブラウザータブで Taskpile にサインインするだけです。

動作確認済みのクライアント：

クライアント	ステータス
Claude.ai（コネクター）	✅
Claude Desktop（mcp-remote 経由）	✅
Claude Code	✅
ChatGPT（コネクター）	✅
Le Chat（Mistral）	✅
Cursor	✅
Zed	✅
MCP Inspector	✅
Lovable.app	✅

クライアント別のクイックスタート

すぐに貼り付けて使える設定例は examples/ をご覧ください：

• Claude Desktop
• Cursor
• Cline（VS Code）
• MCP Inspector

Claude.ai や ChatGPT などのホスト型クライアントでは、組み込みのコネクター UI から Taskpile を追加し、上記の URL を貼り付けてください。ローカルの設定は不要です。

ツール

Taskpile は、タスクの CRUD、プロジェクト、タグ、色、検索、一括操作、チーム、朝のダイジェストやタスクのリマインダーなどのアカウント連携にわたる72 個のツールを公開しています。機械可読な完全スキーマ（名前、説明、入出力の JSON Schema）は、サーバーのツールスキーマから生成された tools.json にあります。

tools/list の内容はアカウントに合わせて調整されるため、通常クライアントに表示されるツールは72個より少なくなります。チーム管理ツールはユーザーがチームに所属すると表示され、プロジェクトメンバーツールは共有プロジェクトを利用できるようになると表示されます。割り当て／トリアージツールは、チーム所有のプロジェクトにアクセスできるようになると表示されます。また、search／fetch は OpenAI クライアントにのみ表示されます。非表示のツールも呼び出し可能です。エントリーポイント（create_team、convert_project_to_shared、invite_to_project、list_received_invitations、accept_invitation）は常に一覧に表示されます。

ツールの一例：

• create_task、list_tasks、update_task、complete_task、delete_task
• assign_horizon（today_morning、tomorrow、next_week など）、delegate_task、set_recurrence
• list_projects、create_project、archive_project
• search_tasks（フリーテキスト + ステータス／期間フィルター）
• bulk_complete、bulk_archive（取り消し可能。bulk_delete よりこちらを推奨）、bulk_delete、bulk_assign_horizon（1回の呼び出しにつき最大200件の ID）
• changes_since（差分同期：削除は報告されないため、定期的に全件を取得して同期してください。1回の呼び出しにつき最大500行）、get_today、get_review_queue
• list_closed_tasks（指定した日付範囲で完了したタスク）
• get_morning_digest、configure_morning_digest、get_task_reminders、configure_task_reminders
• list_colors、create_color、update_color、delete_color
• whoami、get_inbox_email
• チーム：create_team、invite_to_team、accept_invitation、assign_task、convert_project_to_shared など
• search と fetch（ChatGPT コネクター組み込みツール。Taskpile にマッピングされています）

規約

プロンプトを書く際に知っておくと役立つ、プロジェクト全体の規約をいくつか紹介します。

• タグには @tag_name を使います。プロジェクトには #project_name を使います。 タグに # を使わないでください。#foo はプロジェクト名として処理され、警告も表示されません。
• create_task はタイトルから #project と @tag の省略形を解析します。最初の # トークンだけがプロジェクトとして使われ、それ以外は削除されます。
• #name の解決対象には、自分が所有するプロジェクトだけでなく、自分と共有されているプロジェクトも含まれます。名前が一意ならそのプロジェクトが使われます。曖昧な場合（例：同じ名前のプライベートプロジェクトと共有プロジェクトがある場合）は、候補リストを返して呼び出しが失敗します。ユーザーにどちらかを確認してから、明示的な projectId を指定して再試行してください。一致するものがなければ、自分が所有する新しいプロジェクトが作成されます。
• 作成時にタグを設定するには、tags: string[] を渡すか、タイトルに @tag を含めます。両方の形式を使え、重複は除去されます。
• update_task は、タイトルから #／@ の省略形を解析しません。これらを変更するには、tags／addTags／removeTags と projectId を使います。
• 専用の動詞がある場合は、update_task より優先して使ってください：complete_task、assign_horizon、delegate_task。
• 一括エンドポイントでは、1 回の呼び出しにつき最大 200 個の ID を指定できます。

認証フロー

クライアントを構築する際の動作を確認するには、以下を参照してください。

1. クライアントは https://taskpile.app/api/mcp に未認証のリクエストを送信し、WWW-Authenticate: Bearer realm="taskpile", resource_metadata="https://taskpile.app/.well-known/oauth-protected-resource" を伴う 401 を受け取ります。
2. クライアントは https://taskpile.app/.well-known/oauth-protected-resource と …/oauth-authorization-server を取得して、エンドポイントを確認します。
3. クライアントは Dynamic Client Registration（RFC 7591）のために https://taskpile.app/oauth/register に POST します。
4. クライアントは標準の authorization-code + PKCE フローを開始し、ブラウザーで /oauth/authorize を開き、/oauth/token でコードを交換して access_token を受け取ります。
5. 以降のリクエストには Authorization: Bearer <token> を指定します。アクセストークンの有効期間は 30 日間です。refresh_token グラントを登録したクライアントは、有効期間 90 日間のリフレッシュトークンも受け取り、使用のたびにローテーションされます。それ以外のクライアントは、有効期限が切れた際に authorize/token フローを再実行します。トークンは /oauth/revoke（RFC 7009）で取り消せます。

HEAD /api/mcp は認証なしで 200 を返します。これは稼働状態の確認にのみ使用することを想定しています。

プライバシーとデータの取り扱い

• Taskpile は GDPR に準拠しています。MCP 経由で作成されたタスク、プロジェクト、タグはユーザーが所有し、認証済みユーザーにのみ表示されます（共有プロジェクトの場合は、チームメンバーにも表示されます）。
• MCP 統合はタスクの内容を Taskpile のサーバー（EU でホスト）に送信します。Anthropic、OpenAI、その他の LLM プロバイダーを経由することはありません。これらは MCP サーバーのクライアントであり、サーバー自体ではありません。
• パーソナルアクセストークンは Taskpile → Settings → Integrations で作成でき、いつでも取り消せます。

問題とフィードバック

このリポジトリはドキュメント用です。MCP サーバーのバグ報告、新しいツールの機能リクエスト、API に関する質問は、こちらで issue を作成してください。内容を確認して対応します。

Taskpile アプリに関する問題（MCP とは無関係）の場合は、https://taskpile.app のアプリからお問い合わせください。

ライセンス

このリポジトリのドキュメントは MIT ライセンスです（LICENSE を参照）。Taskpile アプリ自体はホスト型の商用製品であり、再配布は許可されていません。