Twist MCP Server (testing)
About
Interact with a Twist workspace using its REST API.
Details
- Author
- mikemc
- Downloads
- 164
- Categories
- Communication, API, Other
Jump to
- 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.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Twist MCP Server (testing)Command (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"twist mcp server (testing)": {
"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"
}
}
}
}
}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"
}
}
}Interact with a Twist workspace using its REST API.
An MCP server for interacting with aTwistworkspace. Written in Python using theTwist REST API. Currently for testing purposes only.
- Python 3.10+
- UV package manager (installation guide)
- Twist API token
- Twist Workspace ID
- Log in to your Twist account
- Visit theTwist App console
- Create a new application for personal use
- 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.
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" } } } }
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
- 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
This project is licensed under the MIT License. See theLICENSEfile for details.
Enables seamless integration with communication platform that allows you to reach your customers globally across any channel.
Interact with any other SaaS applications on behalf of your customers.
Official MCP Server to interact with Pearl API. Connect your AI Agents with 12,000+ certified experts instantly.
Platfone - Receive SMS & Virtual Numbers MCP
Virtual phone number platform for AI agents — rent numbers across 200+ countries, receive SMS, and manage the full activation lifecycle
Send emails directly from your editor using the Resend API.
Sendmux is an email inbox API and email API for AI agents.
Sinch Engage (Sinch MessageMedia in AU) MCP server, which provides Sinch Engage APIs as MCP tools.
Wavix is a global communications platform offering APIs for voice, SMS, 2FA, and phone numbers. Our MCP server brings these capabilities to AI agents and agentic workflows.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
