Twist MCP 服务器（测试中）

用于与Twist工作区交互的 MCP 服务器。使用 Python 编写，使用Twist REST API 。目前仅用于测试目的。

安装

先决条件

• Python 3.10+

• UV 包管理器（安装指南）

• Twist API 令牌

• Twist 工作区 ID

获取 Twist API 令牌

1. 登录您的Twist账户

2. 访问Twist App 控制台

3. 创建供个人使用的新应用程序

4. 复制 OAuth 2 测试令牌；此令牌将授予 MCP 服务器对当前登录用户的完全访问权限。

未来版本将使用适当的 OAuth 身份验证。

使用 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"
      }
    }
  }
}

Related MCP server: mcp-todoist

可用工具

截至目前，以下工具可用：

• 收件箱

  • 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 许可证。详情请参阅许可证文件。