{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_vg2p8qpabxwc","handle":"things-mcp","url":"https://wellknown.network/agents/things-mcp","links":{"self":"https://wellknown.network/agents/things-mcp/record.json","html":"https://wellknown.network/agents/things-mcp","markdown":"https://wellknown.network/agents/things-mcp/record.md","api":"https://wellknown.network/api/v1/agents/things-mcp","status":"https://wellknown.network/api/v1/agents/things-mcp/status","claim":"https://wellknown.network/agents/things-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/things-mcp/claim.json","badge":"https://wellknown.network/agents/things-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/things-mcp/history","tools":"https://wellknown.network/api/v1/agents/things-mcp/tools"},"ard":{"identifier":"urn:air::server:things-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"things-mcp","summary":"Things app Model Context Protocol (MCP) server","description":"# Things MCP Server\n\nThis [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server lets you use ChatGPT, Codex, Claude Desktop, and other MCP clients to interact with your task management data in [Things 3](https://culturedcode.com/things) from Cultured Code. You can ask your assistant to create tasks, analyze projects, help manage priorities, and more.\n\nThis server leverages the [Things.py](https://github.com/thingsapi/things.py) library and the [Things URL Scheme](https://culturedcode.com/things/help/url-scheme/). \n\n## Support the Project\n\nIf you find this project helpful, consider supporting its development:\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/haldick)\n\n## Features\n\n- Access to all major Things lists (Inbox, Today, Upcoming, etc.)\n- Project and area management\n- Tag operations\n- Advanced search capabilities\n- Recent items\n- Detailed item information including checklists\n- Support for nested data (projects within areas, todos within projects)\n- Someday project filtering: tasks in Someday projects are automatically excluded from Today, Upcoming, and Anytime views, matching Things UI behavior\n\n## Installation\n\n### Prerequisites\n- macOS (Things 3 is Mac-only)\n- Things 3 app with \"Enable Things URLs\" turned on (Settings → General)\n- An MCP client, such as the ChatGPT desktop app, Codex, Claude Desktop, or Claude Code\n- [uv](https://docs.astral.sh/uv/) Python package manager: `brew install uv`\n\n### Install via uvx (Any MCP Client)\n\nThings MCP is published on PyPI and can be run directly with `uvx`:\n\n```bash\nuvx things-mcp\n```\n\nConfigure your MCP client to use `uvx` with `things-mcp` as the argument.\n\n### Claude Desktop\n\n#### Option 1: One-Click Install (Recommended)\n\n1. Download the latest file from the [releases page](https://github.com/hald/things-mcp/releases)\n2. Double-click the `.mcpb` file\n3. Done!\n\n#### Option 2: Manual Config\n\n1. Go to **Claude → Settings → Developer → Edit Config**\n2. Add the Thi…","publisher":null,"homepage":"https://github.com/hald/things-mcp","repository":"https://github.com/hald/things-mcp","version":"0.8.2","license":null,"protocols":["mcp"],"tags":["macos","mcp","model-context-protocol","task-management","things"],"pricing":null,"endpoints":[{"url":"pypi:things-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"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.package-management","name":"Packages & Dependencies","confidence":0.768,"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":"things-mcp","registry":"pypi","observedAt":"2026-11-10T04:24:08.446Z","publishedAt":"2026-10-25T01:50:25.013281Z","latestVersion":"0.8.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"things-mcp","url":"https://pypi.org/project/things-mcp/","firstSeenAt":"2026-09-10T14:22:17.179Z","fetchedAt":"2026-11-10T04:23:03.684Z","normalizedAt":"2026-11-10T04:23:03.684Z"}]},"firstSeenAt":"2026-09-10T14:22:17.179Z","updatedAt":"2026-11-10T04:24:08.446Z"}