Things MCP Server

# Things MCP Documentation Welcome to the Things MCP Server documentation. This Model Context Protocol (MCP) server enables AI assistants to interact with Things.app on macOS through a comprehensive set of tools and APIs. ## Documentation Structure ### Getting Started - **[Getting Started Guide](getting-started.md)** - Quick setup and basic usage - **[Installation](getting-started.md#installation)** - Installation methods and configuration ### API Reference - **[API Reference](api-reference.md)** - Complete tool documentation and examples - **[Tool Categories](api-reference.md#tool-categories)** - Overview of available MCP tools ### Development - **[Development Guide](development.md)** - Development workflow and commands - **[Architecture Overview](architecture.md)** - Technical design and patterns - **[Testing](development.md#testing)** - Test strategies and execution ### Troubleshooting & Support - **[Troubleshooting](troubleshooting.md)** - Common issues and solutions - **[Roadmap](roadmap.md)** - Future features and development plans ## Quick Links - [GitHub Repository](https://github.com/BMPixel/things-mcp) - [npm Package](https://www.npmjs.com/package/@wenbopan/things-mcp) - [Model Context Protocol](https://modelcontextprotocol.io/) - [Things.app](https://culturedcode.com/things/) ## Overview The Things MCP Server provides: - **Task Management**: Create, update, and organize tasks - **Project Management**: Handle complex projects with multiple tasks - **Data Access**: Query and export your Things database - **Schedule Integration**: Work with dates, deadlines, and schedules - **Automation**: Streamline task workflows with AI assistance ## Requirements - **macOS**: Things.app is macOS-only - **Things.app**: Version 3.0 or later - **Node.js**: Version 18 or later for development - **MCP Client**: Claude Desktop, Cursor IDE, or other MCP-compatible AI assistant ## Support - **Issues**: [GitHub Issues](https://github.com/BMPixel/things-mcp/issues) - **Contributing**: See [CONTRIBUTING.md](../CONTRIBUTING.md) - **License**: MIT - see [LICENSE](../LICENSE)