{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_2p6d8u6fqt76","handle":"things3-blade-mcp","url":"https://wellknown.network/agents/things3-blade-mcp","links":{"self":"https://wellknown.network/agents/things3-blade-mcp/record.json","html":"https://wellknown.network/agents/things3-blade-mcp","markdown":"https://wellknown.network/agents/things3-blade-mcp/record.md","api":"https://wellknown.network/api/v1/agents/things3-blade-mcp","status":"https://wellknown.network/api/v1/agents/things3-blade-mcp/status","claim":"https://wellknown.network/agents/things3-blade-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/things3-blade-mcp/claim.json","badge":"https://wellknown.network/agents/things3-blade-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/things3-blade-mcp/history","tools":"https://wellknown.network/api/v1/agents/things3-blade-mcp/tools"},"ard":{"identifier":"urn:air::server:things3-blade-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"things3-blade-mcp","summary":"Best-in-class MCP server for Things 3 — token-efficient, full CRUD, AppleScript + URL scheme","description":"# Things 3 MCP Server\n\nBest-in-class [MCP](https://modelcontextprotocol.io) server for [Things 3](https://culturedcode.com/things/) — token-efficient, full CRUD, AppleScript + URL scheme.\n\nBuilt to be the most capable and efficient Things integration for Claude Desktop, Claude Code, and any MCP-compatible client.\n\n## Features\n\n- **Token-efficient output** — concise one-line-per-item by default, detailed on demand\n- **30+ tools** — full coverage of every Things 3 view and operation\n- **Smart Someday filtering** — correctly handles inherited Someday status (matches Things UI exactly)\n- **Random sampling** — `get_random_inbox(5)` for manageable LLM context instead of dumping hundreds of items\n- **Summary mode** — full GTD overview (`get_summary`) in ~20 lines\n- **AppleScript + URL scheme** — reliable writes with UUID feedback; automatic fallback\n- **Bulk JSON import/export** — Things URL scheme JSON format\n- **HTTP transport** — optional remote access with API key authentication\n- **SKILL.md** — self-teaching instructions so Claude uses tools optimally\n\n## Requirements\n\n- **macOS** (Things 3 is macOS/iOS only)\n- **Things 3** installed and running\n- **Python 3.12+**\n- **uv** (recommended) or pip\n\n## Quick Start\n\n### Install and run\n\n```bash\n# Clone and install\ngit clone https://github.com/Groupthink-dev/things3-blade-mcp.git\ncd things3-blade-mcp\nuv sync\n\n# Run (stdio transport — for Claude Desktop)\nuv run things3-blade-mcp\n```\n\n### Claude Desktop configuration\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"things3\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"--directory\", \"/path/to/things3-blade-mcp\", \"things3-blade-mcp\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\n# Add as MCP server\nclaude mcp add things3 -- uv run --directory /path/to/things3-blade-mcp things3-blade-mcp\n```\n\n## Token-Saving Tips\n\nThe server is designed to minimize LLM context consumption:\n\n1. **Start with `get_summary()`** — 20-line GT…","publisher":{"name":"Piers","url":null},"homepage":null,"repository":null,"version":"0.3.0","license":"MIT","protocols":["mcp"],"tags":["applescript","gtd","mcp","task-management","things3"],"pricing":null,"endpoints":[{"url":"pypi:things3-blade-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"things3-blade-mcp","registry":"pypi","observedAt":"2026-11-04T02:26:24.981Z","publishedAt":"2026-06-11T17:26:46.327071Z","latestVersion":"0.3.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"things3-blade-mcp","url":"https://pypi.org/project/things3-blade-mcp/","firstSeenAt":"2026-09-10T14:22:15.963Z","fetchedAt":"2026-11-04T02:25:08.129Z","normalizedAt":"2026-11-04T02:25:08.129Z"}]},"firstSeenAt":"2026-09-10T14:22:15.963Z","updatedAt":"2026-11-04T02:26:24.981Z"}