Twist MCP Server
The Twist MCP Server enables interaction with a Twist workspace through a REST API, offering comprehensive inbox and thread management capabilities.
Inbox Management: Get your inbox, archive/unarchive threads, mark threads as read, and count inbox threads
Thread Operations: Add, update, remove, star, pin, mute, move threads in channels
Reading Status: Mark threads as read/unread, clear unread threads, mark threads as unread for others
Advanced Filtering: Filter threads by date, pinned status, starred status, unread status
Batch Actions: Archive all threads or mark all threads in a workspace/channel as read
Provides comprehensive access to Twist workspace features, including thread management (adding, updating, removing, pinning), inbox operations (retrieving, archiving, marking as read), and thread status management (muting, starring, marking as read/unread).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Twist MCP Server show me my unread threads"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Log in to your Twist account
Visit the Twist 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.
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"
}
}
}
}Related MCP server: mcp-todoist
Available Tools
As of now, the following tools are available:
Inbox
twist_inbox_get: Get the contents of the user's inboxtwist_inbox_archive_all: Archives all threads in a workspace (or, all threads after a given timestamp)twist_inbox_archive: Archives a specific thread by IDtwist_inbox_unarchive: Unarchives a specific thread by IDtwist_inbox_mark_all_read: Marks all inbox threads as readtwist_inbox_get_count: Gets the count of inbox threads
Threads
twist_threads_getone: Get a thread by IDtwist_threads_get: Get all threads in a channeltwist_threads_add: Add a new thread to a channeltwist_threads_update: Update an existing threadtwist_threads_remove: Remove a threadtwist_threads_star: Star a threadtwist_threads_unstar: Unstar a threadtwist_threads_pin: Pin a threadtwist_threads_unpin: Unpin a threadtwist_threads_move_to_channel: Move a thread to a different channeltwist_threads_get_unread: Get unread threads in the workspacetwist_threads_mark_read: Mark a thread as readtwist_threads_mark_unread: Mark a thread as unreadtwist_threads_mark_unread_for_others: Mark a thread as unread for otherstwist_threads_mark_all_read: Mark all threads as read in a workspace or channeltwist_threads_clear_unread: Clear unread threads in the workspacetwist_threads_mute: Mute a thread for a number of minutestwist_threads_unmute: Unmute a thread
License
This project is licensed under the MIT License. See the LICENSE file for details.
Available Tools
24 toolstwist_inbox_archiveB
Archives a thread.
Args: id: The ID of the thread to archive
Inputs: id (required).
twist_inbox_archive_allC
Archives all threads in a workspace.
Args: older_than_ts: Only archives threads that are the same or older than this timestamp
Inputs: older_than_ts.
twist_inbox_getA
Get the authenticated user's inbox.
Args: limit: Limits the number of threads returned (default is 30, maximum is 500) newer_than_ts: Limits threads to those newer when the specified Unix time older_than_ts: Limits threads to those older when the specified Unix time archive_filter: Filter threads based on their is_archived flag: 'all', 'archived', or 'active' (default) order_by: Order of threads: 'desc' (default) or 'asc', based on last_updated attribute exclude_thread_ids: Thread IDs to exclude from results
Inputs: limit, newer_than_ts, older_than_ts, archive_filter, +2 more.
twist_inbox_get_countB
Gets inbox count in a workspace for the authenticated user.
Inputs: no named parameters.
twist_inbox_mark_all_readB
Marks all inbox threads in the workspace as read.
Inputs: no named parameters.
twist_inbox_unarchiveC
Unarchives a thread.
Args: id: The ID of the thread to unarchive
Inputs: id (required).
twist_threads_addC
Adds a new thread to a channel.
Args: channel_id: The id of the channel title: The title of the new thread content: The content of the new thread actions: List of action buttons to the new thread attachments: List of attachments to the new thread direct_group_mentions: The groups that are directly mentioned direct_mentions: The users that are directly mentioned groups: The groups that will be notified recipients: An array of users that will be attached to the thread or "EVERYONE" send_as_integration: Displays the integration as the thread creator temp_id: The temporary id of the thread
Inputs: channel_id (required), title (required), content (required), actions, +7 more.
twist_threads_clear_unreadB
Clears unread threads in workspace.
Inputs: no named parameters.
twist_threads_getB
Gets all threads in a channel.
Args: channel_id: The id of the channel as_ids: If enabled, only the ids of the threads are returned filter_by: A filter can be one of "attached_to_me" or "everyone". Default is "everyone" limit: Limits the number of threads returned (default is 20, maximum is 500) newer_than_ts: Limits threads to those newer when the specified Unix time older_than_ts: Limits threads to those older when the specified Unix time before_id: Limits threads to those with a lower than the specified id after_id: Limits threads to those with a higher than the specified id workspace_id: The id of the workspace is_pinned: If enabled, only pinned threads are returned is_starred: If enabled, only starred threads are returned order_by: The order of the threads returned. Either "desc" (default) or "asc" exclude_thread_ids: The thread ids that should be excluded from the results
Inputs: channel_id (required), as_ids, filter_by, limit, +9 more.
twist_threads_getoneB
Gets a thread object by id.
Args: id: The id of the thread
Inputs: id (required).
twist_threads_get_unreadB
Gets unread threads in a workspace for the authenticated user.
Inputs: no named parameters.
twist_threads_mark_all_readC
Marks all threads in the workspace or channel as read.
Args: workspace_id: The id of the workspace channel_id: The id of the channel
Inputs: workspace_id, channel_id.
twist_threads_mark_readB
Marks the thread as being read.
Args: id: The id of the thread obj_index: The index of the last known read message
Inputs: id (required), obj_index (required).
twist_threads_mark_unreadC
Marks the thread as being unread.
Args: id: The id of the thread obj_index: The index of the last unread message. A value of -1 marks the whole thread as unread
Inputs: id (required), obj_index (required).
twist_threads_mark_unread_for_othersB
Marks the thread as being unread for others.
Args: id: The id of the thread obj_index: The index of the last unread message. A value of -1 marks the whole thread as unread
Inputs: id (required), obj_index (required).
twist_threads_move_to_channelC
Moves the thread to a different channel.
Args: id: The id of the thread to_channel: The target channel's id
Inputs: id (required), to_channel (required).
twist_threads_muteC
Mutes a thread for a number of minutes.
Args: id: The id of the thread minutes: The number of minutes to mute the thread
Inputs: id (required), minutes (required).
twist_threads_pinC
Pins a thread.
Args: id: The id of the thread
Inputs: id (required).
twist_threads_removeC
Removes a thread.
Args: id: The id of the thread
Inputs: id (required).
twist_threads_starC
Stars a thread.
Args: id: The id of the thread
Inputs: id (required).
twist_threads_unmuteC
Unmutes a thread.
Args: id: The id of the thread
Inputs: id (required).
twist_threads_unpinC
Unpins a thread.
Args: id: The id of the thread
Inputs: id (required).
twist_threads_unstarB
Unstars a thread.
Args: id: The id of the thread
Inputs: id (required).
twist_threads_updateC
Updates an existing thread.
Args: id: The id of the thread actions: List of action buttons to the thread attachments: List of attachments to the thread content: The content of the thread direct_group_mentions: The groups that are directly mentioned direct_mentions: The users that are directly mentioned title: The title of the thread
Inputs: id (required), actions, attachments, content, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 24 tools
Every tool has a clearly distinct purpose with no ambiguity. Tools are organized into inbox and threads categories, each targeting specific actions like archive, get, mark read/unread, pin, star, etc., with no overlap in functionality.
All tool names follow a consistent snake_case pattern with a clear prefix (twist_inbox_ or twist_threads_) followed by a verb_noun structure. This makes the tool set highly predictable and easy to navigate.
With 24 tools, the count feels heavy for a messaging/thread management server. While the tools cover many operations, it borders on being excessive, potentially overwhelming for agents to manage efficiently.
The tool set provides comprehensive coverage for inbox and thread management, including CRUD operations (add, get, update, remove), lifecycle actions (archive, pin, star, mute), and state management (read/unread marks). No obvious gaps exist for the domain.
Maintenance
Related MCP Connectors
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
Toggl 2.0 MCP server for tasks, projects, time entries, and workspace operations.
One MCP server for all your work accounts: Slack, Teams, Google Chat, Jira, ClickUp, digest, tasks.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server that integrates Microsoft Teams messaging (read, post, mention, list members and threads)6469Apache 2.0
- AlicenseAqualityDmaintenanceMCP Server to create and manage tasks, projects, labels and more in Todoist, using their unified v1 API727 npm7GPL 3.0
- AlicenseBqualityDmaintenanceAn MCP server that integrates with the Todoist REST API v2 to enable AI assistants to manage tasks, projects, sections, comments, and labels. It supports comprehensive operations including batch task creation, history tracking for completed tasks, and organized project management.331ISC
- FlicenseAqualityDmaintenanceMCP server for the Threads API, enabling profile management, content reading, publishing, replies, and discovery through 26 tools.26-