Twist MCP Server (testing)

@mikemc

About Twist MCP Server (testing)

Twist MCP server

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

`twist_inbox_get`: Get the contents of the user's inbox

`twist_threads_getone`: Get a thread by ID

Overview

What is Twist MCP Server?

Twist MCP Server is an MCP server for interacting with a Twist workspace, built in Python using the Twist REST API. It is currently intended for testing purposes only.

How to use Twist MCP Server?

Install prerequisites (Python 3.10+, UV package manager), obtain a Twist API token and Workspace ID via the Twist App console, then configure the server in Claude Desktop by adding it to claude_desktop_config.json with the uv command and the required environment variables.

Key features of Twist MCP Server

Inbox management: get, archive/unarchive, mark read, get count of inbox threads.
Full thread management: get, add, update, remove, star/unstar, pin/unpin, move channel.
Thread read/unread controls, including marking for others and clearing.
Mute and unmute threads for specified or indefinite durations.
Written in Python, uses UV package manager and Twist REST API.

Use cases of Twist MCP Server

Automate inbox cleanup by archiving all threads or specific threads.
Manage threads: create, update, move between channels, or delete them.
Track unread thread counts and mark threads as read or unread for the workspace.
Star, pin, or mute threads for prioritization and notification control.
Retrieve and organize thread content inside channels.

FAQ from Twist MCP Server

What is this server for?

It is an MCP server for interacting with a Twist workspace, currently for testing purposes only.

How do I get a Twist API token?

Log into Twist, go to the App console, create a personal use application, and copy the OAuth 2 test token which grants full scope access.

What are the runtime requirements?

Python 3.10+, UV package manager, a Twist API token, and a Twist Workspace ID.

What tools does it provide?

It provides tools for inbox management (6 tools) and thread management (18 tools), covering operations like get, archive, star, pin, move, mute, and read/unread.

Is this server production-ready?

No, it is currently for testing only. Future versions will use proper OAuth authentication.

Frequently asked questions

What is this server for?

It is an MCP server for interacting with a Twist workspace, currently for testing purposes only.

How do I get a Twist API token?

Log into Twist, go to the App console, create a personal use application, and copy the OAuth 2 test token which grants full scope access.

What are the runtime requirements?

Python 3.10+, UV package manager, a Twist API token, and a Twist Workspace ID.

What tools does it provide?

It provides tools for inbox management (6 tools) and thread management (18 tools), covering operations like get, archive, star, pin, move, mute, and read/unread.

Is this server production-ready?

No, it is currently for testing only. Future versions will use proper OAuth authentication.

Comments

Basic information

More Other MCP servers

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3