ClaudeとTickTickを連携する方法 — タスク検索・完了・習慣を会話で操作する

TickTickのコネクタをClaudeに接続すると、自分のTickTickアカウントのタスクを会話の中で検索し、完了にし、リストや習慣まで操作できます。提供元はTickTickを運営するAppest Inc、接続先は https://mcp.ticktick.com です。Connectors Directoryには「Anthropic verified」の表示があります。

タスクに加えて、習慣のチェックインや集中記録(フォーカス)まで扱える点が特徴です。ここでは接続手順、使えるツール、日々の使い方、書き込みを絞る設定の順に扱います。Mac上のノートとタスクが中心なら、ClaudeとNotePlanの連携も選べます。

TickTickコネクタでできること

Directoryの説明は「Search, create and manage your tasks/habit it TickTick」です。タスクの追跡・整理・更新を、チャットの流れの中で行えるとされています。

基本情報は次のとおりです。

TickTickヘルプの「TickTick MCP」には、Claudeに次のように話しかける例が載っています。

• 「今日のタスクは?」
• 「明日の午後3時に会議資料を準備するタスクを、優先度高で作って」
• 「『牛乳を買う』を完了にして」

Claudeが適切なツールを自動で選ぶので、ツール名を覚える必要はないと説明されています。

接続する手順

ClaudeまたはClaude Desktopで接続する

Directoryのコネクタは、無料プランを含むすべてのClaudeユーザーが、Claude(ウェブ)・Cowork・Claude Desktop・モバイルアプリで使えます。Team・Enterpriseプランでは、先にOwnerが組織でコネクタを有効にする必要があります。有効にしても全員に権限が自動で渡るわけではなく、各メンバーがTickTickで個別に認証します。ただしTeam・Enterpriseにはベータ版の組織一括認証があり、組織全体で一度認証すれば済む構成も取れます。TickTick側のプラン条件(無料プランで使えるか等)は、TickTickヘルプにもDirectoryにも書かれていません。

Claude Codeで接続する

Claude Codeからは、次のコマンドでMCPサーバーを登録します。

claude mcp add --transport http ticktick \
  https://mcp.ticktick.com

登録したらClaude Codeのセッションで /mcp を実行し、案内に従ってOAuth認可を完了します。

このコマンドが何を書き込むかは、--scope で変わります。Claude Code v2.1.289の claude mcp add --help では、スコープは local / user / project の3種で、既定は local です。--scope project を付けると、プロジェクト直下の .mcp.json に次の内容が書かれます。

claude mcp add --scope project --transport http ticktick \
  https://mcp.ticktick.com
cat .mcp.json

{
  "mcpServers": {
    "ticktick": {
      "type": "http",
      "url": "https://mcp.ticktick.com"
    }
  }
}

TickTickヘルプのCursor用の設定はキーが url だけで、VS Codeは mcpServers ではなく servers です。同じURLでも、クライアントごとに書き方が違います。

OAuthを使わずBearer Tokenで接続する方法もあります。TickTickのウェブ版で、アバターから「Settings > Account & Security > API Token」を開くとトークンを作成できます。取得したトークンは --header で渡します。

claude mcp add --transport http ticktick \
  https://mcp.ticktick.com \
  --header "Authorization: Bearer YOUR_TOKEN_HERE"

YOUR_TOKEN_HERE は自分のトークンに置き換えます。Bearer Tokenを付けて --scope project で登録すると、コマンドの画面では Authorization が [REDACTED] と伏せられる場合があります。一方、.mcp.json にはトークンがそのまま書かれます。

{
  "mcpServers": {
    "ticktick": {
      "type": "http",
      "url": "https://mcp.ticktick.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

.mcp.json はプロジェクトに置いて共有する前提のファイルなので、トークン付きのままコミットすると漏れます。トークンを使うなら、既定の local スコープで登録するのが無難です。

接続できないときの確認点

FAQには、SSEにしか対応しないクライアントからは直接つながらないと明記されています。TickTick MCPはStreamable HTTPだけを受け付けます。claude mcp add の --transport は stdio / sse / http から選ぶので、TickTickには http を指定します。

一度OAuthを済ませれば、トークンは自動更新されます。通常は再認証は要りません。再認証が必要になるのは、長期間使わずにトークンが失効したときと、自分でアクセスを取り消したときです。

使えるツールの全体像

Directoryには「Show all 92 tools」と表示され、search_task と search-task のようにアンダースコア版とハイフン版の名前が並びます。ヘルプのカテゴリ別の表に載る名前は51個で、Directoryの92とは数が合いません。差の理由はDirectoryにもヘルプにも書かれていません。接続後にClaudeのコネクタ画面で実際のツールを見るのが確実です。Claudeのコネクタが10個以上有効なときは、読み込み方を「On demand」にすると会話の余裕が増えるとサポート記事にあります。

ヘルプの表を、用途別にまとめると次のようになります。Directoryの一覧の先頭にある get_user_preference は、ヘルプの表に載っていません。

このほかにコメント(取得・追加・削除)、担当者の割り当て、タグの作成・改名・削除を扱うツールがあります。

ツールごとの上限は、ヘルプの表の補足欄にまとまっています。

日付で未完了タスクを引き出すツール

日々の運用で中心になるのが、未完了タスクを日付で引くツールです。

list_undone_tasks_by_time_query は、あらかじめ決まった期間の未完了タスクを返します。既定では今日の分です。指定できる値は today、last24hour、last7day、tomorrow、next24hour、next7day の6つです。

list_undone_tasks_by_date は、任意の日付範囲を指定します。来月の予定を丸ごと出したいときは、14日ごとに分けて頼むことになります。

完了済みを振り返る list_completed_tasks_by_date は、リストと日付範囲を指定して呼びます。

タスクを検索して完了する

検索の入口は search_task(キーワード)と filter_tasks(複数条件)です。search_task はタスクID・タイトル・リンクなどを返します。

Claudeへの頼み方の例です。ヘルプの例文に沿っています。

• 「今日のタスクは?」
• 「今週の優先度の高いタスクを全部出して」
• 「先週完了したタスクは?」
• 「試験対策リストで未完了のものは?」

完了は complete_task で1件ずつ、または complete_tasks_in_project でリスト単位にまとめて行えます。30件を片づけるなら、後者を2回に分けることになります。

FAQは、意図どおりに動かないときの対処として「リスト名・正確な日付・優先度まで具体的に書く」「複雑な依頼は分けて、先に対象を探させて確認してから実行させる」を挙げています。完了は取り違えの影響が出やすい操作なので、この2段構えが向いています。

今週のうち「買い物」リストの未完了タスクを一覧にして。
IDと期限も付けて。まだ完了にはしないで。

一覧を見て、外したいものがあれば指示し、そのうえで「この一覧の◯番と◯番を完了にして」と頼みます。

タスクをまとめて追加・整理する

create_task はタイトル、説明、日付、優先度、リスト、タグを指定して1件作ります。batch_add_tasks は複数のタスクを一括で作り、各タスクにフィールドを設定できます。

ヘルプの例では、次のように複数の予定を1つの文でまとめて渡しています。

今日は観葉植物を買う、週末は公園に花を見に行く、来週火曜は友人の誕生日のお祝い。全部「生活」リストに追加して。

ヘルプによると、AIがタスクの内容を読み取って期日などを抽出し、登録や整理まで行います。期限がどう解釈されたかは登録後に見直せるよう、追加したタスクの一覧を返すよう頼んでおく手があります。

既存タスクの変更には update_task(タイトル・説明・日付・優先度)、move_task(別リストへ移動)、batch_update_tasks(一括更新)があります。

習慣と集中記録を扱う

TickTickコネクタは、タスク以外に習慣(Habit)も操作できます。

• list_habits で習慣の一覧、get_habit で個別の詳細を取る
• get_habit_checkins でチェックイン記録を読む
• upsert_habit_checkins でチェックインを作成・更新する
• create_habit / update_habit で習慣そのものを作る・変更する

つまり「今週の運動の習慣、何日できていた?」と聞く読み取りと、「昨日の読書にチェックを入れて」という書き込みの両方が会話でできます。記録できるのは過去90日分までで、それより前の日付は扱えません。

集中記録は get_focuses_by_time で読み、create_focus で追加します。update_focus は記録を更新できますが、集中時間そのものは変更できません。

使い方の型はTickTickの活用例に載っている

TickTickは別ページ「TickTick × AI Use Cases」で、MCPかCLIを設定した状態で使えるプロンプト例を公開しています。項目は次のとおりです。

たとえばInbox整理のプロンプトは、新規・未設定・長く放置されたタスクを見直し、曖昧なタスクを行動が分かる表現に直し、リスト・タグ・優先度を提案させる構成です。最後に「修正すべきもの」「移動すべきもの」「予定に入れるもの」「削除すべきもの」の4つに分けて出させます。

「1日の計画」のプロンプトは、予定済みのタスクに加えて「既存のカレンダー予定」も見るよう求めています。ところがTickTick MCPのツール表には、カレンダーの予定を読むツールがありません。ツール表の範囲では、カレンダーの予定はTickTick MCP以外の経路で渡すことになります。

この型をClaude側で使うなら、次のように「実行はまだしない」と明示すると安全です。

TickTickのInboxを見直して。
1. 曖昧なタスクは行動が分かる書き方に直す案を出す
2. リスト・タグ・優先度を提案する
3. 最後に「修正/移動/予定に入れる/削除」の4区分で表にする
この段階では変更を加えず、案だけ出して。

案を見て問題なければ、区分ごとに「移動だけ実行して」と分けて指示します。削除まで一括で任せない運用です。

書き込み系ツールの権限を絞る

delete_task、complete_task、upsert_habit_checkins などは、TickTickのデータを書き換えます。Team・Enterpriseプランでは、Ownerが組織全体で書き込みを禁止でき、その場合は個人では上書きできません。ClaudeのTickTickの画面にTool permissionsがあれば、権限を種類別に制御できます。

1. 「Customize > Connectors」でTickTickを選ぶ
2. 「Tool permissions」に、読み取り専用のツールと書き込み・削除のツールが分かれて表示される
3. 分類ごと、または個別のツールごとに「Always allow」「Needs approval」「Blocked」から選ぶ

検索系を常に許可にして、削除・一括更新だけ承認制にする構成が組めます。なお、Claudeで書き込みを許可しても、TickTick側に権限がなければ変更はできません。Claude側の制限は権限を狭めるだけで、広げることはありません。

使う前に知っておきたい注意点

他のコネクタや機能との使い分け

同じタスク管理でも、DoistのサービスならClaudeとTodoistコネクタでタスクを検索・完了する方法が対象です。TickTick側の特徴は、ツール表に習慣と集中記録が含まれていることです。

日程調整が主ならClaudeとCalendlyを連携する方法が近く、定期的な作業をClaude側に持たせたいならCoworkスケジュールタスクの作成方法が対象です。

MCPとCLIのどちらを使うか

TickTickは、MCPのほかに公式のCLIも出しています。活用例のページは、どちらかを設定済みであることを前提にしています。

APIトークンの場所は、2つのページで書き方が違います。MCPのヘルプは「Settings > Account & Security > API Token」、CLIのヘルプは「Settings > Account > API Token」です。画面の項目名が合わなければ、設定のAccount周辺を探します。

CLIのヘルプによると、対応範囲はMCPと同じく基本のタスク・リスト・習慣・集中記録・カウントダウンです。会話の中で完結させたいならMCP、ターミナルでコマンドとして打ちたいならCLIです。

まとめ

TickTickコネクタは、日付指定の未完了タスク、完了、追加、リスト整理に加え、習慣のチェックインと集中記録まで会話で操作できます。接続はDirectoryからの追加が最短で、Claude Codeなら claude mcp add の1行で済みます。

運用の要は、対象を一覧で確認してから書き込みに進む順序です。書き込み系ツールを「承認が必要」にしておけば、意図しない完了や削除を実行前に止められます。