excelsier/things-fastmcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

36 stars 15 forks Качество 58 Тренд 12NOASSERTION

Repository Install

Усовершенствованная реализация FastMCP сервера Things MCP для Claude и Windsurf

Обзор

Этот сервер Model Context Protocol (MCP) позволяет использовать Claude Desktop для взаимодействия с данными управления задачами в приложении Things. Вы можете попросить Клода создать задачи, проанализировать проекты, помочь управлять приоритетами и многое другое. Этот сервер использует библиотеку Things.py и схему URL Things с дополнительными функциями надежности, включая: - с экспоненциальными механизмами обратного и повторного входа - для предотвращения каскадных сбоев - для неудачных операций - для повышения производительности - со структурированным выходом JSON - для операций, которые терпят неудачу со схемами URL - для предотвращения перегрузки приложения Things - для надежности Этот MCP-сервер разблокирует возможности ИИ для управления задачами: Попросите Клода создать задачи со всеми деталями на естественном языке : Получите представление о ваших проектах и моделях производительности - : Пусть Клод поможет вам внедрить системы производительности - : Работает непосредственно с вашими существующими данными Things 3 Доступ ко всем основным спискам вещей (Inbox, Today, Upcoming и т. Д.).

Обзор (машинный перевод)

Этот сервер использует библиотеку Things.py и схему URL Things с дополнительными функциями надежности, включая:

Устойчивая обработка ошибок с экспоненциальными механизмами обратного и повторного использования -План выключателя для предотвращения каскадных отказов ** Очередь мертвых писем** для неудачных операций ** Интеллектуальное кэширование** для повышения производительности Всеобъемлющая рубка со структурированным выходом JSON AppleScript Bridge для операций, которые не работают с URL-схемами ** Ограничение ставок ** для предотвращения перегрузки приложения Things ** Обширный набор тестов** для обеспечения надежности

##Почему MCP?

Этот MCP-сервер разблокирует возможности ИИ для управления задачами:

Создание естественной языковой задачи: попросите Клода создать задачи со всеми деталями на естественном языке Умный анализ задач: Получите представление о ваших проектах и моделях производительности GTD & Productivity Workflows: Позвольте Клоду помочь вам внедрить системы производительности

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Things MCP Server

This Model Context Protocol (MCP) server lets you use Claude Desktop to interact with your task management data in Things app. You can ask Claude to create tasks, analyze projects, help manage priorities, and more.

This server leverages the Things.py library and the Things URL Scheme, with additional reliability features including:

Robust error handling with exponential backoff and retry mechanisms
Circuit breaker pattern to prevent cascading failures
Dead letter queue for failed operations
Intelligent caching for improved performance
Comprehensive logging with structured JSON output
AppleScript bridge for operations that fail with URL schemes
Rate limiting to prevent overwhelming the Things app
Extensive test suite for reliability

Why Things MCP?

This MCP server unlocks the power of AI for your task management:

Natural Language Task Creation: Ask Claude to create tasks with all details in natural language
Smart Task Analysis: Get insights into your projects and productivity patterns
GTD & Productivity Workflows: Let Claude help you implement productivity systems
Seamless Integration: Works directly with your existing Things 3 data

Features

Access to all major Things lists (Inbox, Today, Upcoming, etc.)
Project and area management
Tag operations
Advanced search capabilities
Recent items tracking
Detailed item information including checklists
Support for nested data (projects within areas, todos within projects)

Installation Options

There are multiple ways to install and use the Things MCP server:

Option 1: Install from PyPI (Recommended)

Prerequisites

Python 3.12+
Claude Desktop
Things 3 (“Enable Things URLs” must be turned on in Settings -> General)
Things Authentication Token (required for URL scheme operations)

Installation

pip install things-mcp

Or using uv (recommended):

uv pip install things-mcp

Running

After installation, you can run the server directly:

things-mcp

Option 2: Manual Installation

Prerequisites

Python 3.12+
Claude Desktop
Things 3 (“Enable Things URLs” must be turned on in Settings -> General)

Step 1: Install uv

Install uv if you haven’t already:

curl -LsSf https://astral.sh/uv/install.sh | sh

Restart your terminal afterwards.

Step 2: Clone this repository

git clone https://github.com/hald/things-mcp
cd things-mcp

Step 3: Set up Python environment and dependencies

uv venv
uv pip install -r pyproject.toml

Step 4: Configure Things authentication token

Run the configuration tool to set up your Things authentication token:

python configure_token.py

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
    "mcpServers": {
        "things": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/things-mcp",
                "run",
                "things_server.py"
            ]
        }
    }
}