Twist MCP Server (testing)

Twist MCP サーバー（テスト中）

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

インストール

前提条件

• Python 3.10+
• UV パッケージマネージャー（インストールガイド）
• Twist API トークン
• Twist ワークスペース ID

Twist API トークンの取得

1. Twist アカウントにログインします
2. Twist App コンソールにアクセスします
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"
      }
    }
  }
}

利用可能なツール

現在、以下のツールを利用できます。

• 受信トレイ
  • 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 ファイルをご覧ください。