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., "@Todo4Agent Create a task "call dentist" in my Personal group for tomorrow"
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.
An MCP todo list designed for Agents: Agents can manage your tasks directly through MCP, and you can also maintain them manually in the interface.
Task groups and task management: create, edit, complete, due date, sort
Recycle bin: accidentally deleted items can be recovered
Multi-user: each user's task data is independent
Import / export JSON for backup and migration
Desktop apps (Windows / macOS / Linux) and browser WebUI (default http://127.0.0.1:3000)
The WebUI listens on 0.0.0.0 by default, so other devices on the LAN can access it directly; you can turn off external access or change the port in Settings → Service
New user registration is enabled by default and can be turned off in Settings → Users
MCP Service: Agents can operate directly on the task list through the standard MCP protocol
Related MCP server: TickTick MCP Server
Download the package for your platform from GitHub Releases. The service port and external listening can be changed in Settings → Service (default 3000 / listen on 0.0.0.0).
The system comes with an initial account:
Username: admin
Password: admin123
After logging in, please change your password in Settings → Users as soon as possible; you can also register your own new account directly (the registration button is enabled by default).
Configure in an Agent client that supports MCP:
{
"mcpServers": {
"todo4agent": {
"command": "todo4agent",
"args": ["mcp"],
"env": {
"TODO4AGENT_USERNAME": "你的用户名",
"TODO4AGENT_PASSWORD": "你的密码"
}
}
}
}The Agent can then run create/read/update/delete, reorder, import/export, and other operations on your task list. The "Agent Integration" page in the UI lets you copy the client configuration with one click. Available tools:
Tool | Description |
| Query application version / release page URL |
| Task group management (deleting a group also sends its tasks to the recycle bin) |
| Query and edit tasks (supports moving between groups, changing status, due date) |
| Toggle complete / delete (soft delete to recycle bin) |
| Export task list JSON (same as the UI export) / import (merge into groups with the same name) |
Credentials: at MCP startup, you must specify and verify the account via
TODO4AGENT_USERNAME/TODO4AGENT_PASSWORD(the database automatically creates the initial account admin / admin123 on first run); startup is rejected if verification fails.
Task data is stored in a local SQLite database. Export and import JSON via Settings → Data in the interface.
Developer Documentation: DEVELOPMENT.md
Changelog: CHANGELOG.md
License: GNU AGPL-3.0
This server cannot be deployed
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Create, list, and complete todo items through MCP.
Task management your AI agents can actually run. One line becomes a context-ready task over MCP.