Сервер Twist MCP (тестирование)

MCP-сервер для взаимодействия с рабочим пространством Twist . Написан на Python с использованием Twist REST API . В настоящее время только для целей тестирования.

Установка

Предпосылки

• Питон 3.10+

• Менеджер пакетов UV ( руководство по установке )

• API-токен Twist

• Идентификатор рабочего пространства Twist

Получение токена Twist API

1. Войдите в свою учетную запись Twist

2. Посетите консоль приложения Twist

3. Создайте новое приложение для личного использования

4. Скопируйте тестовый токен OAuth 2; этот токен предоставит серверу MCP полный доступ к текущему вошедшему в систему пользователю.

В будущих версиях будет использоваться корректная аутентификация OAuth.

Конфигурация с Claude Desktop

Добавьте сервер Twist MCP в набор серверов MCP в вашем 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

Доступные инструменты

На данный момент доступны следующие инструменты:

• Входящие

  • twist_inbox_get : Получить содержимое почтового ящика пользователя

  • twist_inbox_archive_all : Архивирует все потоки в рабочей области (или все потоки после заданной временной метки)

  • twist_inbox_archive : Архивирует определенную ветку по идентификатору

  • twist_inbox_unarchive : Разархивирует определенную ветку по идентификатору

  • twist_inbox_mark_all_read : Отмечает все входящие сообщения как прочитанные

  • twist_inbox_get_count : Получает количество входящих сообщений

• Темы

  • twist_threads_getone : Получить поток по идентификатору

  • twist_threads_get : Получить все потоки в канале

  • twist_threads_add : Добавить новую ветку на канал

  • twist_threads_update : Обновить существующую ветку

  • twist_threads_remove : Удалить тему

  • twist_threads_star : Отметить тему звездой

  • twist_threads_unstar : Удалить звездочку с темы

  • twist_threads_pin : Закрепить тему

  • twist_threads_unpin : Открепить поток

  • twist_threads_move_to_channel : Переместить поток на другой канал

  • twist_threads_get_unread : Получить непрочитанные темы в рабочей области

  • twist_threads_mark_read : Отметить тему как прочитанную

  • twist_threads_mark_unread : Отметить тему как непрочитанную

  • twist_threads_mark_unread_for_others : Отметить ветку как непрочитанную для других

  • twist_threads_mark_all_read : Отметить все потоки как прочитанные в рабочей области или канале

  • twist_threads_clear_unread : Очистить непрочитанные темы в рабочей области

  • twist_threads_mute : Отключить звук в теме на несколько минут

  • twist_threads_unmute : Включить звук в теме

Лицензия

Этот проект лицензирован по лицензии MIT. Подробности см. в файле LICENSE .