Twist

You can run a Twist MCP Server to interact with your Twist workspace from an MCP client. It exposes a set of tools to read and manage inboxes and threads, enabling automation and integration with your existing workflows.

How to use

You deploy the Twist MCP Server locally and connect it to your MCP client. Once running, you can call tools to fetch inbox contents, archive threads, manage read status, and perform common thread operations such as creating, updating, moving, pinning, or muting threads. This enables you to automate routine Twist actions and integrate Twist data into your broader workflow.

How to install

Prerequisites you need before running the server:

• Python 3.10+

• UV package manager (installation guide)

• Twist API token

• Twist Workspace ID

Get your Twist API token and workspace ID ready. The token grants full scope access to the currently logged in user.

Add the Twist MCP server to the MCP configuration used by your Claude Desktop client. Create or update your claude_desktop_config.json with the following structure:

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

Additional setup notes

This server is intended for testing purposes. In the future, OAuth authentication will be used instead of a personal access token.

Configuration and security notes

• The server requires a Twist API token with access to the specified workspace. Treat this token as a sensitive credential.
• Store tokens and workspace IDs securely and don’t commit them to public version control.
• If you need to rotate tokens, update the environment variables in your MCP client configuration and restart the server.

Troubleshooting

• If the MCP client cannot connect, verify that the uv process is running and that the directory path to the server is correct.
• Confirm that TWIST_API_TOKEN and TWIST_WORKSPACE_ID are set in the environment and accessible to the MCP runner.
• Check that Python 3.10+ is installed and that the uv package manager is available on your system.

Available tools

twist_inbox_get

Get the contents of the user's inbox

twist_inbox_archive_all

Archive all threads in a workspace (or all threads after a given timestamp)

twist_inbox_archive

Archive a specific thread by ID

twist_inbox_unarchive

Unarchive a specific thread by ID

twist_inbox_mark_all_read

Mark all inbox threads as read

twist_inbox_get_count

Get the count of inbox threads

twist_threads_getone

Get a thread by ID

twist_threads_get

Get all threads in a channel

twist_threads_add

Add a new thread to a channel

twist_threads_update

Update an existing thread

twist_threads_remove

Remove a thread

twist_threads_star

Star a thread

twist_threads_unstar

Unstar a thread

twist_threads_pin

Pin a thread

twist_threads_unpin

Unpin a thread

twist_threads_move_to_channel

Move a thread to a different channel

twist_threads_get_unread

Get unread threads in the workspace

twist_threads_mark_read

Mark a thread as read

twist_threads_mark_unread

Mark a thread as unread

twist_threads_mark_unread_for_others

Mark a thread as unread for others

twist_threads_mark_all_read

Mark all threads as read in a workspace or channel

twist_threads_clear_unread

Clear unread threads in the workspace

twist_threads_mute

Mute a thread for a number of minutes

twist_threads_unmute

Unmute a thread