Todo4Agent

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.

Features

• 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

Installation

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).

Getting Started

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).

Agent Integration (MCP)

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:

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.

Data

Task data is stored in a local SQLite database. Export and import JSON via Settings → Data in the interface.

Documentation

• Developer Documentation: DEVELOPMENT.md

• Changelog: CHANGELOG.md

• License: GNU AGPL-3.0