Integrate
The HTTP API, the ot command, MCP, webhooks and calendars. 12 pages.
- HTTP API
Authentication, every route, entity fields, error codes and examples for scripts and integrations.
- Command-line client
The ot command: install, sign in, add and complete tasks, JSON output, exit codes, dry runs and safe use by AI agents.
- Markdown vault
Keep a folder of Markdown files in two-way sync with your account, readable by Obsidian Tasks and Dataview, plus your TaskNotes task notes, with ot vault.
- Webhooks
Events, payload, signature checks, retries and recipes for Home Assistant, n8n and Telegram.
- Home Assistant
The Home Assistant integration: install it from HACS, the token to use, the lists, counts, calendar and events, Assist, automations and limits.
- Calendar sync
Two-way sync with your own calendar: dated tasks become events in iCloud, Fastmail, Nextcloud, Google, Outlook, Microsoft 365 or any CalDAV calendar, and moving an event moves the task.
- Show Focus elsewhere
Show the running Focus session on a panel beside the screen, a Home Assistant card, in a terminal or to an AI assistant, without a second timer.
- n8n
The n8n community nodes: install them, the token to use, the task, project, label and comment operations, the signed trigger, example workflows, AI agents and limits.
- Issue import
Bring the open GitHub and GitLab issues assigned to you into OpenTodo as tasks that complete when the issue closes.
- AI assistants (MCP)
Give an AI assistant access to your tasks over the Model Context Protocol, read-only or, when you allow it, with changes you can undo.
- OAuth clients for AI assistants
Connect an app that signs in with OAuth instead of taking a pasted token, such as Google Gemini, ChatGPT or Claude (claude.ai).
- Use OpenTodo from Claude Code
Install the OpenTodo plugin in Claude Code to connect Claude to your own server, with skills that teach it to read and plan your tasks safely.