Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@things-mcp show my todos due today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A Python CLI MCP (Model Context Protocol) server for Things 3, enabling programmatic access to todos and projects, including filtering by due date. Designed for automation, scripting, and integration with other tools.
Query all todos and projects from Things 3
Filter todos by project or due date (YYYY-MM-DD)
Clean, type-safe, and test-driven codebase
CLI installable and easy to run
Automation via justfile (run, test, lint, format, upgrade, etc.)
Related MCP server: Things Cloud MCP
uv pip install --break-system-packages .Start the MCP server:
things-mcpOr, for development:
just runExample request to get all todos:
{"method": "get-todos"}Example request to get todos due today:
{"method": "get-todos", "params": {"due_date": "2025-06-24"}}{"method": "get-projects"}Run tests: just test
Lint: just lint
Format: just format
Upgrade deps: just upgrade
Add pre-commit hooks: just precommit
Clean: just clean
See CONTRIBUTING.md for guidelines. Please read our Code of Conduct.
See CHANGELOG.md for release history.
See SECURITY.md for reporting vulnerabilities. Contact: [your-email@example.com]
Apache License, Version 2.0. See LICENSE.
This server cannot be deployed
Official Todoist MCP server for AI assistants to manage tasks, projects, and workflows.
MCP server for Linear project management and issue tracking
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
