PlugWiki
Mindwtr logo

Mindwtr MCP Server: Setup for Claude, Cursor and Other Apps

OfficialLocal
Getnpmmindwtr-mcpdongdongbh/mindwtr

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.

Install Mindwtr MCP

Claude Code

  1. 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. 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_tasks

  • Reads one task

    Fetches a single task with all its fields by ID.

    Try: “Open the task about the tax return.”

    Read · mindwtr_get_task

  • Lists your projects

    Returns the projects in your Mindwtr data.

    Try: “What projects do I have?”

    Read · mindwtr_list_projects

  • Reads one project

    Fetches a single project by ID.

    Try: “Show details of the Website project.”

    Read · mindwtr_get_project

  • Lists your areas

    Returns your areas of responsibility.

    Try: “List my areas.”

    Read · mindwtr_list_areas

  • Lists 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_sections

  • Reads one project section

    Fetches a single project section by ID.

    Try: “Show the Design section.”

    Read · mindwtr_get_section

  • Lists people you track

    Returns the managed people in your data, used for delegated tasks.

    Try: “Who is on my people list?”

    Read · mindwtr_list_people

  • Reads one person

    Fetches a single managed person by ID.

    Try: “Show the entry for Alex.”

    Read · mindwtr_get_person

  • Adds 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_task

  • Edits a task

    Changes fields of an existing task. Needs the write option.

    Try: “Move the tax task to next Monday.”

    Write · mindwtr_update_task

  • Marks a task done

    Sets a task to done. Needs the write option.

    Try: “Mark the dentist task as done.”

    Write · mindwtr_complete_task

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

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-onlyThe npm package is read-only by default. Add --write to turn on add, update, complete and delete tools.
Talks toOnly your own Cloud URL if you choose Cloud mode
Scopes
  • Local Mindwtr database file

  • Optional Local API token or self-hosted Cloud token

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

WebsiteGitHubnpmOfficial MCP RegistryChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 2
  1. Mindwtr MCP server README · github.com
  2. Mindwtr MCP tool registrations · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.