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).
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:
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.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
An MCP server that enables interaction with Twist workspaces using the Twist REST API, allowing users to manage their Twist inbox by viewing, archiving, unarchiving, and marking threads as read.
Related MCP Servers
- -securityFlicense-qualityThis is an MCP server that facilitates building tools for interacting with various APIs and workflows, supporting Python-based development with potential for customizable prompts and user configurations.Last updated -Python
- AsecurityFlicenseAqualityAn MCP server implementation that enables interaction with the Unstructured API, providing tools to list, create, update, and manage sources, destinations, and workflows.Last updated -3932
- AsecurityAlicenseAqualityAn MCP server that connects to the Teamwork API, providing a simplified interface for interacting with Teamwork projects and tasks.Last updated -35910TypeScriptMIT License
- -securityFlicense-qualityAn MCP server that enhances TickTick workflow by providing comprehensive task management tools with improved filtering capabilities, allowing AI assistants and MCP-compatible applications to interact with TickTick tasks with greater precision.Last updated -24Python