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
Twist REST API를 사용하여 Twist 작업 공간과 상호작용할 수 있는 MCP 서버로, 사용자는 스레드를 보고, 보관하고, 보관 취소하고, 읽은 것으로 표시하여 Twist 받은 편지함을 관리할 수 있습니다.
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 -3933
- AsecurityAlicenseAqualityAn MCP server that connects to the Teamwork API, providing a simplified interface for interacting with Teamwork projects and tasks.Last updated -36512TypeScriptMIT 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 -29Python