Twist MCP サーバー (テスト)

Twistワークスペースと連携するための MCP サーバーです。Twist REST APIを使用して Python で記述されています。現在はテスト目的のみで使用されています。

インストール

前提条件

• Python 3.10以上

• UV パッケージ マネージャー (インストール ガイド)

• Twist APIトークン

• Twist ワークスペース ID

Twist APIトークンの取得

1. Twistアカウントにログイン

2. Twist アプリコンソールにアクセスしてください

3. 個人使用のための新しいアプリケーションを作成する

4. OAuth 2 テスト トークンをコピーします。このトークンにより、MCP サーバーは現在ログインしているユーザーにフル スコープ アクセスを許可します。

将来のバージョンでは適切な OAuth 認証が使用されます。

Claude Desktopによる構成

claude_desktop_config.json 内の MCP サーバーのセットに Twist MCP サーバーを追加します。

{
  "mcpServers": {
    "twist": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/twist-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "TWIST_API_TOKEN": "your_twist_api_token",
        "TWIST_WORKSPACE_ID": "your_twist_workspace_id"
      }
    }
  }
}

Related MCP server: mcp-todoist

利用可能なツール

現在、次のツールが利用可能です。

• 受信トレイ

  • twist_inbox_get : ユーザーの受信トレイの内容を取得する

  • twist_inbox_archive_all : ワークスペース内のすべてのスレッド（または、指定されたタイムスタンプ以降のすべてのスレッド）をアーカイブします。

  • twist_inbox_archive : IDで特定のスレッドをアーカイブする

  • twist_inbox_unarchive : IDで特定のスレッドをアーカイブ解除する

  • twist_inbox_mark_all_read : 受信トレイのすべてのスレッドを既読としてマークします

  • twist_inbox_get_count : 受信トレイのスレッド数を取得します

• スレッド

  • twist_threads_getone : IDでスレッドを取得する

  • twist_threads_get : チャネル内のすべてのスレッドを取得する

  • twist_threads_add : チャネルに新しいスレッドを追加する

  • twist_threads_update : 既存のスレッドを更新する

  • twist_threads_remove : スレッドを削除する

  • twist_threads_star : スレッドにスターを付ける

  • twist_threads_unstar : スレッドのスターを外す

  • twist_threads_pin : スレッドをピン留めする

  • twist_threads_unpin : スレッドのピンを解除する

  • twist_threads_move_to_channel : スレッドを別のチャネルに移動する

  • twist_threads_get_unread : ワークスペース内の未読スレッドを取得する

  • twist_threads_mark_read : スレッドを既読としてマークする

  • twist_threads_mark_unread : スレッドを未読としてマークする

  • twist_threads_mark_unread_for_others : スレッドを他のユーザーに対して未読としてマークする

  • twist_threads_mark_all_read : ワークスペースまたはチャンネル内のすべてのスレッドを既読としてマークする

  • twist_threads_clear_unread : ワークスペース内の未読スレッドをクリアする

  • twist_threads_mute : スレッドを一定時間ミュートする

  • twist_threads_unmute : スレッドのミュートを解除する

ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルをご覧ください。