Twist MCP Server (testing)

@mikemc

代码仓库

基本信息

分类

其他

许可证

MIT license

传输方式

stdio

作者

mikemc

关于 Twist MCP Server

Twist MCP server

Twist MCP Server 配置

使用下面的配置,将此服务器添加到你的 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 MCP Server 工具

`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.

常见问题

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.

Is this server production-ready?

No, it is currently for testing only. Future versions will use proper OAuth authentication.

其他分类下的更多 MCP 服务器

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w