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.