Ticktick MCP Server

🚀 点动点 (TickTick) MCP サーバー

このサーバーは、TickTick アプリケーションとのインタラクションを可能にする MCP（マルチファンクションコントロールプロセッサ）サーバーです。コマンドラインや他の統合方法を通じて、TickTick のタスク、リマインダー、その他の機能を自動化および管理することができます。

🚀 クイックスタート

このセクションでは、TickTick MCP サーバーのクイックスタートについて説明します。

✨ 主な機能

TickTick API 機能

タスクとリマインダーの管理

• タスクの作成：REST または RPC インターフェースを通じて、新しいタスクやリマインダーを追加します。
• タスクの更新：既存のタスクの状態、優先度、その他の属性を変更します。
• タスクの削除：指定されたタスク ID を使用してタスクを削除します。
• タスクの検索：特定のタスクを検索したり、タグで分類したりします。

タイムゾーンとカレンダーの統合

• 複数のタイムゾーンをサポートし、世界中のユーザーが正しく時間を同期できるようにします。
• Google Calendar や他のサードパーティのカレンダーサービスと統合します。

バッチ操作

• 複数のタスクを一括で作成、更新、または削除します。
• データを CSV または JSON 形式でエクスポートし、さらなる処理を行います。

📦 インストール

1. 依存関係のインストール

Node.js と npm がインストールされていることを確認してください。

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
source ~/.bashrc
nvm install --lts
npm install -g @alexarevalo.ai/mcp-server-ticktick

2. MCP サーバーの起動

以下のコマンドを実行してサーバーを起動します。

npx @alexarevalo.ai/mcp-server-ticktick start

📚 ドキュメント

TickTick MCP サーバーの使用上の注意事項

セキュリティに関する注意

• .env ファイルを .gitignore に追加し、機密情報がバージョン管理システムにコミットされないようにしてください。
• 定期的にアクセストークンを更新し、セキュリティリスクを減らしてください。

ライセンス

この MCP サーバーは MIT ライセンスに基づいて配布されています。これは、ソフトウェアを自由に使用、変更、配布できることを意味しますが、MIT ライセンスの条項に従う必要があります。詳細については、プロジェクトリポジトリの LICENSE ファイルを参照してください。

TickTick MCP サーバーの設定

1. 環境変数の設定

.env ファイルを作成し、以下の内容を追加します。

TICKTICK_CLIENT_ID=your_client_id
TICKTICK_CLIENT_SECRET=your_client_secret
TICKTICK_ACCESS_TOKEN=your_access_token

2. 初回の認証フロー

サーバーを初めて実行するときは、認証フローを完了する必要があります。

1. MCP サーバーがブラウザを開き、TickTick のログインページにリダイレクトします。
2. あなたの TickTick アカウントでログインします。
3. アプリケーションに必要な権限を付与します。
4. 生成されたアクセストークンがブラウザに表示されますので、それをコピーして環境変数 TICKTICK_ACCESS_TOKEN に設定してください。

TickTick 開発者コンソール

TickTick 開発者ポータルへのアクセス

以下のリンクから TickTick の開発者コンソールにアクセスできます。https://developer.ticktick.com/manage

アプリの作成と資格情報の取得

1. ログイン後、「アプリ管理」ページに移動します。
2. 「新しいアプリを作成」をクリックします。
3. アプリ情報を入力し、送信します。
4. アプリ詳細ページで、CLIENT_ID と CLIENT_SECRET を見つけます。

例：Claude Desktop の設定

Claude Desktop で TickTick MCP サーバーを設定するには、以下のようにします。

{
  "mcpServers": [
    {
      "name": "ticktick-mcp",
      "type": "custom",
      "host": "localhost",
      "port": "3000",
      "protocol": "http"
    }
  ]
}

よくある質問

新しいアクセストークンを生成する方法は？

1. TickTick 開発者コンソールで、「資格情報」ページに移動します。
2. 「新しいトークンを生成」をクリックします。
3. 指示に従って認証フローを完了し、新しいアクセストークンを取得します。

サーバーが起動しない場合はどうすればいいですか？

• 環境変数が正しく設定されていることを確認してください。
• ネットワーク接続が正常であることを確認してください。
• コンソール出力を確認し、エラー情報を取得してください。

まとめ

TickTick MCP サーバーは、TickTick アプリケーションのタスクやリマインダー機能を自動化および管理する強力な手段を提供します。シンプルなコマンドラインインターフェースまたは RPC 呼び出しを通じて、タスクのバッチ操作、カレンダー統合、その他の高度な機能を簡単に実現できます。