SSyncDev

Twist MCP Server

An MCP server for interacting with a [Twist](https://twist.com/home) workspace. Written in Python using the [Twist REST

Local serverstdioPython

What is the Twist MCP Server?

Twist mcp server lets Claude, Cursor and other MCP clients work with Twist directly. An MCP server for interacting with a Twist workspace. Written in Python using the Twist REST API. Currently for testing purposes only.

What Twist does

An MCP server for interacting with a Twist workspace. Written in Python using the Twist REST API. Currently for testing purposes only.

Requirements

  • Python 3.10+ - UV package manager (installation guide) - Twist API token - Twist Workspace ID

Practical notes

  • Maintained by mikemc, written in Python.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
Inboxtwist_inbox_get: Get the contents of the user's inbox
twist_inbox_archive_allArchives all threads in a workspace (or, all threads after a given timestamp)
twist_inbox_archiveArchives a specific thread by ID
twist_inbox_unarchiveUnarchives a specific thread by ID
twist_inbox_mark_all_readMarks all inbox threads as read
twist_inbox_get_countGets the count of inbox threads
Threadstwist_threads_getone: Get a thread by ID
twist_threads_getGet all threads in a channel
twist_threads_addAdd a new thread to a channel
twist_threads_updateUpdate an existing thread
twist_threads_removeRemove a thread
twist_threads_starStar a thread
twist_threads_unstarUnstar a thread
twist_threads_pinPin a thread
twist_threads_unpinUnpin a thread
twist_threads_move_to_channelMove a thread to a different channel
twist_threads_get_unreadGet unread threads in the workspace
twist_threads_mark_readMark a thread as read
twist_threads_mark_unreadMark a thread as unread
twist_threads_mark_unread_for_othersMark a thread as unread for others
twist_threads_mark_all_readMark all threads as read in a workspace or channel
twist_threads_clear_unreadClear unread threads in the workspace
twist_threads_muteMute a thread for a number of minutes
twist_threads_unmuteUnmute a thread

How to install the Twist MCP Server

{
  "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"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.10+ - UV package manager (installation guide) - Twist API token - Twist Workspace ID
VariableDescriptionRequired
TWIST_API_TOKENDeclared in the maintainer’s client configuration.Check documentation
TWIST_WORKSPACE_IDDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Twist to Inbox.”
  • “Use Twist to twist inbox archive all.”
  • “Use Twist to twist inbox archive.”

Frequently asked questions

An MCP server for interacting with a [Twist](https://twist.com/home) workspace. Written in Python using the [Twist REST API](https://developer.twist.com/v3/). Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.