Skip to main content
Glama
Twist MCP Server
by mikemc

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

Getting a Twist API Token

  1. Log in to your Twist account

  2. Visit the Twist App console

  3. Create a new application for personal use

  4. 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 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

  • 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

License

This project is licensed under the MIT License. See the LICENSE file for details.

Available Tools

24 tools
twist_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

    B3.4/5.0

    Scored across 24 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP Server to create and manage tasks, projects, labels and more in Todoist, using their unified v1 API
      7
      27 npm
      7
      GPL 3.0
    • A
      license
      B
      quality
      D
      maintenance
      An 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.
      33
      1
      ISC
    • F
      license
      A
      quality
      D
      maintenance
      MCP server for the Threads API, enabling profile management, content reading, publishing, replies, and discovery through 26 tools.
      26
      -