Advertise
MCP.so
Sign In

Twist MCP Server (testing)

@mikemc

Repository

Basic information

Category

Other

License

MIT license

Transports

stdio

Author

mikemc

About Twist MCP Server

Twist MCP server

Twist MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "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"
      }
    }
  }
}

Twist MCP Server tools

2

`twist_inbox_get`: Get the contents of the user's inbox

`twist_threads_getone`: Get a thread by ID

Overview

What is Twist MCP Server?

Twist MCP Server is an MCP server for interacting with a Twist workspace, built in Python using the Twist REST API. It is currently intended for testing purposes only.

How to use Twist MCP Server?

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.

Key features of Twist MCP Server

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

Use cases of Twist MCP Server

  • Automate inbox cleanup by archiving all threads or specific threads.
  • Manage threads: create, update, move between channels, or delete them.
  • Track unread thread counts and mark threads as read or unread for the workspace.
  • Star, pin, or mute threads for prioritization and notification control.
  • Retrieve and organize thread content inside channels.

Frequently asked questions

1

What is this server for?

It is an MCP server for interacting with a Twist workspace, currently for testing purposes only.

2

How do I get a Twist API token?

Log into Twist, go to the App console, create a personal use application, and copy the OAuth 2 test token which grants full scope access.

3

What are the runtime requirements?

Python 3.10+, UV package manager, a Twist API token, and a Twist Workspace ID.

4

What tools does it provide?

It provides tools for inbox management (6 tools) and thread management (18 tools), covering operations like get, archive, star, pin, move, mute, and read/unread.

5

Is this server production-ready?

No, it is currently for testing only. Future versions will use proper OAuth authentication.

Comments

More Other MCP servers

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Advertise