{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_33yen9c666fj","handle":"things3-mcp","url":"https://wellknown.network/agents/things3-mcp","links":{"self":"https://wellknown.network/agents/things3-mcp/record.json","html":"https://wellknown.network/agents/things3-mcp","markdown":"https://wellknown.network/agents/things3-mcp/record.md","api":"https://wellknown.network/api/v1/agents/things3-mcp","status":"https://wellknown.network/api/v1/agents/things3-mcp/status","claim":"https://wellknown.network/agents/things3-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/things3-mcp/claim.json","badge":"https://wellknown.network/agents/things3-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/things3-mcp/history","tools":"https://wellknown.network/api/v1/agents/things3-mcp/tools"},"ard":{"identifier":"urn:air::server:things3-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"things3-mcp","summary":"A server implementation for interacting with Things3 app on macOS through Claude AI","description":"# MCP Server for Things3\n\nA robust MCP (Model Context Protocol) server providing comprehensive integration with Things3, allowing you to create, manage, and search tasks and projects through the MCP protocol. Features ID-based task management, JSON-based AppleScript integration, and Things3 philosophy guidance.\n\n## Features\n\n- ✅ **Create Projects & Todos**: Full metadata support with checklists, tags, and dates\n- ✅ **Update Tasks**: Modify any task property using task IDs with auth token support\n- ✅ **View Tasks**: List tasks from Inbox, Today, Upcoming, Anytime, or Projects\n- ✅ **Complete Tasks**: Mark todos as completed using their ID\n- ✅ **Search Functionality**: Search through all todos by title or content\n- ✅ **Things3 Philosophy**: Built-in guidance for effective task management\n- ✅ **JSON Integration**: Reliable data extraction using Foundation framework\n- ✅ **Today Overload Warning**: Alerts when Today list exceeds 4 items\n\n## Installation\n\n### Prerequisites\n- macOS with Things3 installed\n- Python 3.10+ \n- Things3 running (for real-time operations)\n- Things3 auth token (for update operations)\n\n### Install the Server\n\n1. Clone this repository:\n   ```bash\n   git clone <repository-url>\n   cd mcp-things3\n   ```\n\n2. Install using pip:\n   ```bash\n   pip install -e .\n   ```\n\n3. The server will be available as `mcp-server-things3`\n\n### Auth Token Setup\n\nFor update operations, you need to set your Things3 auth token:\n\n1. Open Things3\n2. Go to Settings → General → Enable Things URLs → Manage\n3. Copy your auth token\n4. Set the environment variable:\n   ```bash\n   export THINGS3_AUTH_TOKEN=\"your-token-here\"\n   ```\n\n## Tools Available\n\n### View Operations\n\n#### `view-inbox`\nView all todos in the Things3 inbox.\n- **Parameters**: None\n- **Returns**: List of inbox todos with IDs, titles, tags, and metadata\n\n#### `view-todos`\nView all todos in today's list with overload warning.\n- **Parameters**: None\n- **Returns**: List of today's todos with IDs and warning if >4 items\n\n###…","publisher":null,"homepage":"https://github.com/darinkishore/mcp-things3","repository":"https://github.com/darinkishore/mcp-things3","version":"0.2.0","license":"MIT","protocols":["mcp"],"tags":["claude","macos","mcp","task-management","things3"],"pricing":null,"endpoints":[{"url":"pypi:things3-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"productivity.tasks","name":"Tasks & To-do","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.791,"provenance":"derived"}],"categories":["dev","productivity"],"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-mcp","registry":"pypi","observedAt":"2026-11-04T02:26:25.021Z","publishedAt":"2025-07-21T21:26:47.633410Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"things3-mcp","url":"https://pypi.org/project/things3-mcp/","firstSeenAt":"2026-09-10T14:22:16.207Z","fetchedAt":"2026-11-04T02:25:08.382Z","normalizedAt":"2026-11-04T02:25:08.382Z"}]},"firstSeenAt":"2026-09-10T14:22:16.207Z","updatedAt":"2026-11-04T02:26:25.021Z"}