Twist MCP Server is an MCP server that connects AI assistants to a Twist workspace via the Twist REST API. Built in Python, this tool enables users such as software engineers, project managers, and remote team members to interact directly with asynchronous team discussions from MCP-compatible clients like Claude Desktop. The server exposes an interface for reading, organizing, and managing both inbox notifications and channel threads without opening the Twist web or desktop application. By bridging Twist with AI models, it allows users to inspect thread contents, fetch unread messages, and track collaboration updates in channels. Users can also perform active workspace administration tasks, including creating new discussion threads, updating existing posts, archiving inbox items, starring important topics, and muting irrelevant conversations. It provides fine-grained thread state controls, allowing agents to mark threads as read or unread across entire workspaces or for specific discussions. This setup streamlines team communication workflows by integrating asynchronous conversation oversight directly into development and desktop AI environments.
Category: Communication & Messaging
Tags: collaboration, messaging, team-chat, twist
claude_desktop_config.json file: 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" } } } } 5. Restart Claude Desktop to enable the Twist tools.Part of MCP Servers
Twist MCP Server enables Model Context Protocol clients to interact with a Twist workspace. It allows you to inspect inbox notifications, archive or unarchive threads, count unread items, create new channel threads, and edit existing messages. It also supports organizing threads by pinning, starring, moving them between channels, or muting notifications.
Twist MCP Server works with any client that implements the Model Context Protocol, including Claude Desktop. The official documentation includes step-by-step instructions for adding the server to the claude_desktop_config.json configuration file. Any other MCP-compatible interface that supports executing local commands with environment variables can also run the server.
To configure the server, log in to your Twist account and open the Twist App console. Create a new personal application and copy the provided OAuth 2 test token, which grants full account access for the current user. You will also need your Twist Workspace ID, both of which are passed as environment variables.
Yes, Twist MCP Server is open-source software licensed under the MIT License. Users can freely view the source code, inspect implementation details, adapt the server for custom workflows, and report issues directly on its GitHub repository.