Twist MCP Server (testing)

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

Installation

Prerequisites

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

Getting a Twist API Token

1. Log in to your Twist account
2. Visit the Twist App console
3. Create a new application for personal use
4. Copy the OAuth 2 test token; this token will give the MCP server full scope access to the currently logged in user.

Future versions will use proper OAuth authentication.

Configuration with Claude Desktop

Add the Twist MCP server to the set of MCP servers in your claude_desktop_config.json:

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

Available Tools

To see currently available tools, run:

# With GNU grep installed as ggrep (as with `brew install grep` on Mac)
ggrep -Po '(?<=^mcp.tool\(\)\()([^)]+)' main.py

As of now, the following tools are available:

• Inbox
  • twist_inbox_get: Get the contents of the user's inbox
  • twist_inbox_archive_all: Archives all threads in a workspace (or, all threads after a given timestamp)
  • twist_inbox_archive: Archives a specific thread by ID
  • twist_inbox_unarchive: Unarchives a specific thread by ID
  • twist_inbox_mark_all_read: Marks all inbox threads as read
  • twist_inbox_get_count: Gets the count of inbox threads

License

This project is licensed under the MIT License. See the LICENSE file for details.