Mindwtr MCP
The Mindwtr task manager MCP server: an agent reads GTD tasks, projects and areas, and writing needs a separate flag.
- 2,393 ★ on the repository
- Last commit
- AGPL-3.0
Extended access
Why this level
- Reads personal tasks and projects and, with the `--write` flag, changes and deletes them.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/mindwtr-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads personal tasks and projects and, with the `--write` flag, changes and deletes them.
This is third-party code. Review the repository files before installing.
What it does
Mindwtr is a free personal task app built on GTD with an offline mode and no account. The `mindwtr-mcp` package connects an assistant to it over stdio and works in three modes: directly against the local SQLite database, through the desktop app Local API, or against your own Mindwtr Cloud server. By default the server only reads: it returns lists of tasks, projects, areas, sections and people, plus a single task record. Tools such as `mindwtr_add_task`, `mindwtr_update_task`, `mindwtr_complete_task` and `mindwtr_delete_task` work only after the `--write` flag. Edits are version-guarded: the assistant passes the received token as `expectedVersion`, and a stale edit is rejected. The desktop app also has its own built-in MCP server that is enabled in the integrations settings.
Who it is for. People who keep their tasks in Mindwtr and want to triage the inbox, plan the week and close tasks through an assistant.
Good fit when
- Weekly review: the assistant lists stalled projects and waiting tasks.
- New tasks with a project and an area are added to Mindwtr from a conversation with the agent.
- In the morning you need a task list for today from several areas.
- After a meeting the assistant marks tasks done and moves the rest.
Not a fit when
- Tasks live in another app: the server works with Mindwtr only.
- You need access from a phone: the mobile apps do not host an MCP server.
- An agent cannot be trusted to delete tasks without review.
Example request
Show projects with no next action and tasks in waiting, then add the task "call the bank" to the Home area.MCP
- Transport
- stdio, http
- Authentication
- not required
Environment variables
MINDWTR_DB_PATH- Path to the local Mindwtr SQLite database.
MINDWTR_MCP_API_TOKENsecret- Desktop app Local API token for API mode.
MINDWTR_MCP_CLOUD_TOKENsecret- Token of your own Mindwtr Cloud server.
Limitations
The standalone package needs Node.js 20 or newer, preferably 22 for prebuilt SQLite binaries. SQLite mode needs the native `better-sqlite3` module installed, and with npm 12 its install script must be allowed with `--allow-scripts=better-sqlite3`. In Local API mode pass the token through an environment variable. Mobile apps do not support MCP. The HTTP transport is opt-in for people who host the server themselves.
How to disable. Remove the mindwtr entry from the client MCP configuration and run `npm uninstall -g mindwtr-mcp` for the package. The desktop app built-in server is turned off in the integrations settings.
FAQ
How do I connect Mindwtr to Claude Desktop?
Add a `mindwtr` entry to `claude_desktop_config.json` with the command `npx` and the arguments `-y mindwtr-mcp --db <path to mindwtr.db>`, then fully restart the app. The database path depends on the OS and app version.
How do I let the assistant change tasks?
Add the `--write` argument. Without it only read tools work. A task response carries a version that must be sent back as `expectedVersion` when editing.
Do I need a separate MCP with the desktop app?
No, the desktop app has its own built-in server: enable it in Settings, Integrations, Local MCP server. The separate package is for server and cloud scenarios.
How do I connect my own cloud server?
Set `--cloud-url` and the token through `MINDWTR_MCP_CLOUD_TOKEN`. The server reads the `/v1/data` snapshot and with `--write` writes through the cloud REST endpoints.
Where is the Mindwtr database?
Linux: `~/.local/share/mindwtr/mindwtr.db`. macOS from version 1.3.2: `~/Library/Application Support/mindwtr/data/mindwtr.db`. Windows: `%APPDATA%\mindwtr\data\mindwtr.db`. The server also checks the older locations.
Discussion
No questions or reviews yet.
Related
MCP serversMicrosoft To Do MCP gives an agent tasks with checklist items and recurrence rules for working on the user’s own plans.
The official Taskade MCP and plugin: an agent manages workspace projects, tasks, automations and AI agents.
An MCP server for Todoist: Claude creates, finds, edits, completes and deletes tasks from an ordinary phrase, with five tools
The official Todoist MCP server: the agent finds, creates and updates tasks and projects in your account
Teamwork.com tasks, Desk tickets, Spaces pages and chats for an agent: a hosted server with role profiles and a read-only mode
MCP server for Super Productivity: an agent creates tasks, sorts them by project and tag, starts the timer and reads the worklog.
README in short
The `apps/mcp-server` directory of the Mindwtr monorepo holds the published package. It reads and writes the same data as the desktop app and supports idempotency keys for retried task creation.