Twist MCP Server (testing)

Name: Twist MCP Server (testing)
Author: mikemc

@mikemc

リポジトリ

Twist MCP Server (testing) について

Twist MCP server

基本情報

カテゴリ

その他

ライセンス

MIT license

ランタイム

python

トランスポート

stdio

公開者

mikemc

設定

以下の設定を使って、このサーバーを 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`: Get the contents of the user's inbox

`twist_threads_getone`: Get a thread by ID

概要

What is Twist MCP Server?

Twist MCP Server is an MCP server for interacting with a Twist workspace, built in Python using the Twist REST API. It is currently intended for testing purposes only.

How to use Twist MCP Server?

Install prerequisites (Python 3.10+, UV package manager), obtain a Twist API token and Workspace ID via the Twist App console, then configure the server in Claude Desktop by adding it to claude_desktop_config.json with the uv command and the required environment variables.

Key features of Twist MCP Server

Inbox management: get, archive/unarchive, mark read, get count of inbox threads.
Full thread management: get, add, update, remove, star/unstar, pin/unpin, move channel.
Thread read/unread controls, including marking for others and clearing.
Mute and unmute threads for specified or indefinite durations.
Written in Python, uses UV package manager and Twist REST API.

Use cases of Twist MCP Server

Automate inbox cleanup by archiving all threads or specific threads.
Manage threads: create, update, move between channels, or delete them.
Track unread thread counts and mark threads as read or unread for the workspace.
Star, pin, or mute threads for prioritization and notification control.
Retrieve and organize thread content inside channels.

FAQ from Twist MCP Server

What is this server for?

It is an MCP server for interacting with a Twist workspace, currently for testing purposes only.

How do I get a Twist API token?

Log into Twist, go to the App console, create a personal use application, and copy the OAuth 2 test token which grants full scope access.

What are the runtime requirements?

Python 3.10+, UV package manager, a Twist API token, and a Twist Workspace ID.

What tools does it provide?

It provides tools for inbox management (6 tools) and thread management (18 tools), covering operations like get, archive, star, pin, move, mute, and read/unread.