excelsier/things-fastmcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

36 stars 15 forks 품질 58 트렌드 12NOASSERTION

Repository Install

Enhanced FastMCP implementation of the Things MCP server for Claude and Windsurf

개요

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: - with exponential backoff and retry mechanisms - to prevent cascading failures - for failed operations - for improved performance - with structured JSON output - for operations that fail with URL schemes - to prevent overwhelming the Things app - for reliability This MCP server unlocks the power of AI for your task management: - : Ask Claude to create tasks with all details in natural language - : Get insights into your projects and productivity patterns - : Let Claude help you implement productivity systems - : Works directly with your existing Things 3 data - Access to all major Things lists (Inbox, Today, Upcoming, etc.

README

원문 README의 일부입니다. 원문 보기.

Things MCP Server

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

GitHub에서 전체 README 보기

설치

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