Twist MCP Server (testing)

基本能力

产品定位

Twist MCP Server 是一个用于与 Twist 工作区交互的 MCP 服务器，旨在提供对 Twist 工作区的自动化访问和管理功能。

核心功能

• 获取用户收件箱内容
• 归档工作区中的所有线程或特定时间后的线程
• 归档特定线程
• 取消归档特定线程
• 标记所有收件箱线程为已读
• 获取收件箱线程数量

适用场景

• 自动化管理 Twist 工作区的收件箱
• 批量处理 Twist 工作区的线程
• 集成 Twist 工作区功能到其他系统中

工具列表

• twist_inbox_get: 获取用户收件箱内容
• twist_inbox_archive_all: 归档工作区中的所有线程或特定时间后的线程
• twist_inbox_archive: 归档特定线程
• twist_inbox_unarchive: 取消归档特定线程
• twist_inbox_mark_all_read: 标记所有收件箱线程为已读
• twist_inbox_get_count: 获取收件箱线程数量

常见问题解答

• 目前仅支持使用 OAuth 2 测试令牌进行身份验证，未来版本将支持完整的 OAuth 认证。

使用教程

使用依赖

• Python 3.10+
• UV 包管理器
• Twist API 令牌
• Twist 工作区 ID

安装教程

1. 登录 Twist 账户
2. 访问 Twist App console
3. 创建新的个人用途应用程序
4. 复制 OAuth 2 测试令牌

配置 Claude Desktop

将 Twist MCP 服务器添加到 claude_desktop_config.json 中的 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"
      }
    }
  }
}

调试方式

要查看当前可用的工具，运行：

# 使用 GNU grep 安装为 ggrep (如在 Mac 上使用 `brew install grep`)
ggrep -Po '(?<=^mcp.tool\(\)\()([^)]+)' main.py

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。