Best-in-class MCP server for Things 3 — token-efficient, full CRUD, AppleScript + URL scheme
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"things3-blade-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Things 3 MCP Server Best-in-class [MCP](https://modelcontextprotocol.io) server for [Things 3](https://culturedcode.com/things/) — token-efficient, full CRUD, AppleScript + URL scheme. Built to be the most capable and efficient Things integration for Claude Desktop, Claude Code, and any MCP-compatible client. ## Features - **Token-efficient output** — concise one-line-per-item by default, detailed on demand - **30+ tools** — full coverage of every Things 3 view and operation - **Smart Someday filtering** — correctly handles inherited Someday status (matches Things UI exactly) - **Random sampling** — `get_random_inbox(5)` for manageable LLM context instead of dumping hundreds of items - **Summary mode** — full GTD overview (`get_summary`) in ~20 lines - **AppleScript + URL scheme** — reliable writes with UUID feedback; automatic fallback - **Bulk JSON import/export** — Things URL scheme JSON format - **HTTP transport** — optional remote access with API key authentication - **SKILL.md** — self-teaching instructions so Claude uses tools optimally ## Requirements - **macOS** (Things 3 is macOS/iOS only) - **Things 3** installed and running - **Python 3.12+** - **uv** (recommended) or pip ## Quick Start ### Install and run ```bash # Clone and install git clone https://github.com/Groupthink-dev/things3-blade-mcp.git cd things3-blade-mcp uv sync # Run (stdio transport — for Claude Desktop) uv run things3-blade-mcp ``` ### Claude Desktop configuration Add to `~/Library/Application Support/Claude/claude_desktop_config.json`: ```json { "mcpServers": { "things3": { "command": "uv", "args": ["run", "--directory", "/path/to/things3-blade-mcp", "things3-blade-mcp"] } } } ``` ### Claude Code ```bash # Add as MCP server claude mcp add things3 -- uv run --directory /path/to/things3-blade-mcp things3-blade-mcp ``` ## Token-Saving Tips The server is designed to minimize LLM context consumption: 1. **Start with `get_summary()`** — 20-line GT…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.