
Mindwtr MCP Server: Setup for Claude, Cursor and Other Apps
Lets Claude or Cursor read and manage your Mindwtr tasks, projects and areas.
This server comes from the Mindwtr project. It runs on your computer and reads your Mindwtr task database. It can also talk to the desktop app's Local API or to a Mindwtr Cloud server you host yourself.
It is read-only until you start it with the write option. The desktop app also has its own built-in MCP server in Settings, which needs no separate install.
Good for
- Mindwtr users who want an assistant to plan their week
- People doing GTD who want task review done in chat
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install Mindwtr MCP
Claude Code
- 1
Copy this prompt.
Add the Mindwtr MCP server to Claude Code. Run this command: claude mcp add mindwtr -- npx --allow-scripts=better-sqlite3 -y mindwtr-mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js 20+.
Read-only mode: The npm package is read-only by default. Add --write to args only if you want add, update, complete and delete tools.
The README says npm 12 needs the --allow-scripts=better-sqlite3 flag for the SQLite add-on; without it the install can succeed and then fail at start with a missing native binding. It is included in every config here. Drop it if your npm is older and complains. Add --db /path/to/mindwtr.db to args if the app's database is not in the default folder. The server is read-only until you add --write. The wrapper commands and non-JSON configs are adapted from the README by us.
Built from the package data we hold. Not yet tested by us.
Tools
Lists and searches your tasks
Returns tasks filtered by status, project, date range or focus, with search operators, sorting and paging.
Try: “Show my tasks due this week in the Website project.”
Read ·
mindwtr_list_tasksReads one task
Fetches a single task with all its fields by ID.
Try: “Open the task about the tax return.”
Read ·
mindwtr_get_taskLists your projects
Returns the projects in your Mindwtr data.
Try: “What projects do I have?”
Read ·
mindwtr_list_projectsReads one project
Fetches a single project by ID.
Try: “Show details of the Website project.”
Read ·
mindwtr_get_projectLists your areas
Returns your areas of responsibility.
Try: “List my areas.”
Read ·
mindwtr_list_areasLists sections inside projects
Returns project sections, optionally for one project. Not available through the desktop Local API.
Try: “Show the sections of the Website project.”
Read ·
mindwtr_list_sectionsReads one project section
Fetches a single project section by ID.
Try: “Show the Design section.”
Read ·
mindwtr_get_sectionLists people you track
Returns the managed people in your data, used for delegated tasks.
Try: “Who is on my people list?”
Read ·
mindwtr_list_peopleReads one person
Fetches a single managed person by ID.
Try: “Show the entry for Alex.”
Read ·
mindwtr_get_personAdds a task
Creates a task with the title and fields you give. Needs the write option.
Try: “Add a task: call the dentist, due Friday.”
Write ·
mindwtr_add_taskEdits a task
Changes fields of an existing task. Needs the write option.
Try: “Move the tax task to next Monday.”
Write ·
mindwtr_update_taskMarks a task done
Sets a task to done. Needs the write option.
Try: “Mark the dentist task as done.”
Write ·
mindwtr_complete_taskDeletes a task
Soft-deletes a task so it moves to the trash. Needs the write option.
Try: “Delete the old reminder task.”
Delete ·
mindwtr_delete_taskBrings back a deleted task
Restores a task that was soft-deleted. Needs the write option.
Try: “Restore the task I deleted by mistake.”
Write ·
mindwtr_restore_taskAdds a project
Creates a project with title, color, status, area and sequential setting. Needs the write option.
Try: “Create a project called Kitchen renovation.”
Write ·
mindwtr_add_projectEdits a project
Changes fields of a project. Needs the write option.
Try: “Rename the project to Home renovation.”
Write ·
mindwtr_update_projectDeletes a project
Soft-deletes a project. Needs the write option.
Try: “Delete the finished Trip project.”
Delete ·
mindwtr_delete_projectAdds a project section
Creates a section inside a project. Needs the write option.
Try: “Add a section called Research to the Website project.”
Write ·
mindwtr_add_sectionEdits a project section
Changes a project section. Needs the write option.
Try: “Rename the Research section to Discovery.”
Write ·
mindwtr_update_sectionDeletes a project section
Soft-deletes a section. Its tasks are kept and moved to no section. Needs the write option.
Try: “Delete the empty Misc section.”
Delete ·
mindwtr_delete_sectionAdds an area
Creates an area. If one with the same name exists, nothing is created and that area is returned. Needs the write option.
Try: “Add an area called Health.”
Write ·
mindwtr_add_areaEdits an area
Changes an area. Needs the write option.
Try: “Rename the area Home to Household.”
Write ·
mindwtr_update_areaDeletes an area
Soft-deletes an area. Needs the write option.
Try: “Delete the area Old job.”
Delete ·
mindwtr_delete_areaAdds a person
Adds a managed person. Needs the write option.
Try: “Add Alex to my people list.”
Write ·
mindwtr_add_personEdits a person
Changes a managed person's details. Needs the write option.
Try: “Update Alex's notes.”
Write ·
mindwtr_update_personRenames a person
Renames a managed person and by default updates the tasks assigned to them too. Needs the write option.
Try: “Rename Alex to Alexander everywhere.”
Write ·
mindwtr_rename_personDeletes a person
Soft-deletes a managed person. Needs the write option.
Try: “Remove Alex from my people list.”
Delete ·
mindwtr_delete_person
Read from the source code
Permissions
low risk · 2 things to watch
Low risk
By default it can only read your task data. If you add the write option, the assistant can edit and delete items, so only add it when you want that.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
The write option adds edit and delete tools
With --write, the assistant can change tasks, projects, areas, sections and people, and soft-delete them. Deleted items go to the trash and tasks can be restored. github.com
The HTTP mode needs its own token
The optional --http mode serves the helper at a URL. Use the separate auth token it asks for and keep it on a trusted network. github.com
Security advisories
No published security advisories for the MCP server as of Nov 1, 2026.
1 other advisory is about the wider Mindwtr project, not this MCP server. See them on GitHub
Technical details
| Turning on read-only | The npm package is read-only by default. Add --write to turn on add, update, complete and delete tools. |
|---|---|
| Talks to | Only your own Cloud URL if you choose Cloud mode |
| Scopes |
|
Questions
Is the Mindwtr MCP server official?
Yes. It ships in the Mindwtr project's own repository, next to the app.
Is it read-only?
Yes by default. The write tools only work when you start the server with the write option, and delete tools are soft deletes.
Do I need an API key?
Not for the default local database mode. The desktop Local API mode needs the token from the app settings, and self-hosted Cloud mode needs your Cloud token.
Where does it find my tasks?
It looks for mindwtr.db in the app's default data folder on Linux, macOS and Windows. You can point it elsewhere with a database path option.
Does it work without installing anything?
The desktop app has a built-in local MCP server in its settings, so that route needs no separate install. The npm package needs Node.js 20 or newer. On npm 12 the SQLite add-on needs the --allow-scripts=better-sqlite3 flag, which the install box above already includes.
Does it run on my computer or in the cloud?
On your computer. Cloud mode only connects to a Mindwtr Cloud server you run yourself.
Can I use it on my phone?
No. The mobile apps do not expose a local MCP server.
Information
updated Nov 2, 2026
- Publisher
- Official
- Package
mindwtr-mcp- Registry
- npm
- Transport
- stdio, Streamable HTTP
- Auth
- None
- Version
- 1.1.13
- License
- AGPL-3.0-only
- Last commit
- Oct 30, 2026
- Open issues
- 132
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- Mindwtr MCP server README · github.com
- Mindwtr MCP tool registrations · github.com