MCP Server

Active

AGPL-3.0

Mindwtr MCP Server

io.github.dongdongbh/mindwtr

LLM automation for your local Mindwtr GTD tasks and projects, with read-only self-hosted cloud access.

What is the Mindwtr MCP server?

Mindwtr MCP server is a stdio Model Context Protocol server (published as `mindwtr-mcp` on npm) that lets LLM clients like Claude or Cursor automate the local Mindwtr GTD (Getting Things Done) app. It exposes task and project data from Mindwtr's local-first store for automation, and supports read-only access to self-hosted Mindwtr Cloud instances.

Mindwtr is a free, open-source, local-first, cross-platform GTD (Getting Things Done) task manager with no account required. The Mindwtr MCP server is an optional automation layer, distributed as the npm package `mindwtr-mcp`, that runs as a local stdio MCP server so AI agents can interact with your Mindwtr tasks and projects (e.g., capture, list, complete, search) alongside the app's existing CLI and local REST API. It also supports read-only access to a self-hosted Mindwtr Cloud deployment, letting an LLM read project/task data without full write access to a hosted instance.

How to install Mindwtr

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

MINDWTR_DB_PATH
Optional path to the local Mindwtr SQLite database.
MINDWTR_MCP_CLOUD_URL
Optional self-hosted Mindwtr Cloud base URL for read-only Cloud mode.
MINDWTR_MCP_CLOUD_TOKEN
Bearer token for read-only self-hosted Mindwtr Cloud mode.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mindwtr": {
      "command": "npx",
      "args": [
        "-y",
        "mindwtr-mcp"
      ],
      "env": {
        "MINDWTR_DB_PATH": "<YOUR_MINDWTR_DB_PATH>",
        "MINDWTR_MCP_CLOUD_URL": "<YOUR_MINDWTR_MCP_CLOUD_URL>",
        "MINDWTR_MCP_CLOUD_TOKEN": "<YOUR_MINDWTR_MCP_CLOUD_TOKEN>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mindwtr": {
      "command": "npx",
      "args": [
        "-y",
        "mindwtr-mcp"
      ],
      "env": {
        "MINDWTR_DB_PATH": "<YOUR_MINDWTR_DB_PATH>",
        "MINDWTR_MCP_CLOUD_URL": "<YOUR_MINDWTR_MCP_CLOUD_URL>",
        "MINDWTR_MCP_CLOUD_TOKEN": "<YOUR_MINDWTR_MCP_CLOUD_TOKEN>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mindwtr": {
      "command": "npx",
      "args": [
        "-y",
        "mindwtr-mcp"
      ],
      "env": {
        "MINDWTR_DB_PATH": "<YOUR_MINDWTR_DB_PATH>",
        "MINDWTR_MCP_CLOUD_URL": "<YOUR_MINDWTR_MCP_CLOUD_URL>",
        "MINDWTR_MCP_CLOUD_TOKEN": "<YOUR_MINDWTR_MCP_CLOUD_TOKEN>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mindwtr": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mindwtr-mcp"
      ],
      "env": {
        "MINDWTR_DB_PATH": "<YOUR_MINDWTR_DB_PATH>",
        "MINDWTR_MCP_CLOUD_URL": "<YOUR_MINDWTR_MCP_CLOUD_URL>",
        "MINDWTR_MCP_CLOUD_TOKEN": "<YOUR_MINDWTR_MCP_CLOUD_TOKEN>"
      }
    }
  }
}

Claude Code

claude mcp add mindwtr --env MINDWTR_DB_PATH=<YOUR_MINDWTR_DB_PATH> --env MINDWTR_MCP_CLOUD_URL=<YOUR_MINDWTR_MCP_CLOUD_URL> --env MINDWTR_MCP_CLOUD_TOKEN=<YOUR_MINDWTR_MCP_CLOUD_TOKEN> -- npx -y mindwtr-mcp

Use cases

Let an AI assistant capture, list, complete, or search Mindwtr tasks via natural language
Automate GTD workflows (clarify inbox, organize projects) using an LLM connected through MCP
Query read-only task/project data from a self-hosted Mindwtr Cloud instance
Integrate Mindwtr task automation into Claude Desktop or Cursor alongside the existing local REST API and CLI

Mindwtr MCP server FAQ

What does the Mindwtr MCP server do?

It runs as a local stdio Model Context Protocol server that exposes Mindwtr's task and project data to LLM clients for automation (e.g., adding, listing, completing, searching tasks), and provides read-only access to a self-hosted Mindwtr Cloud instance.

Is the Mindwtr MCP server free?

Yes, Mindwtr is free and open-source, and the MCP server is published as a free npm package (`mindwtr-mcp`).

How do I install it for Claude or Cursor?

Install globally with `npm install -g mindwtr-mcp`, or have your MCP client launch it directly with `npx -y mindwtr-mcp`; it's also listed in the MCP Registry.

Does it require authentication?

For local use it runs as a stdio server against your local Mindwtr data with no account required; the related desktop REST API uses a generated bearer token on 127.0.0.1:3456, and self-hosted Cloud access is read-only.

Does this replace the Mindwtr app?

No, it's an optional automation add-on to the Mindwtr GTD app, complementing the existing CLI and local REST API rather than replacing the app itself.

Can it write data to a hosted Mindwtr Cloud?

No, according to the description, self-hosted Cloud access via this server is read-only; full read/write automation applies to local Mindwtr data.

README (reference)

Source of truth, from the repository.

Mindwtr

English | 中文

The free, open-source, cross-platform GTD app. Local-first, no account required. Mind Like Water.

New to GTD? Read GTD in 15 minutes for a quick introduction.

Getting Started · FAQ · Docs · Data & Sync · Cloud Deployment · MCP Server

<p> <i>Local-First GTD on Arch Linux & Android</i> </p> </div>

Why Mindwtr (Quick Comparison)

Mindwtr is built for people who want a complete GTD system without lock-in. Here is a brief, respectful comparison with mainstream task apps and GTD-focused alternatives.

Capability	Mindwtr	Todoist	TickTick	Everdo	NirvanaHQ
Open source	✅	❌	❌	❌	❌
GTD-native workflow	✅	⚠️	⚠️	✅	✅
All major platforms (desktop + mobile + web, incl. Linux desktop)	✅	✅	✅	⚠️	⚠️
Local-first + no account required	✅	❌	❌	✅	❌
AI assistant (BYOK + local LLM)	✅	❌	❌	❌	❌
Flexible sync (WebDAV / Dropbox / self-hosted / local file)	✅	❌	❌	⚠️	❌
Completely free	✅	❌	❌	❌	❌

Legend: ✅ = yes, ❌ = no, ⚠️ = partial/limited support.

This comparison is based on the current public capabilities of each product. If any entry is outdated, feel free to open an issue or PR with sources.

Philosophy

Mindwtr is built to be simple by default and powerful when you need it. We focus on reducing cognitive load, cutting the fat, and keeping you in flow. That means:

Progressive disclosure: advanced options stay hidden until they matter.
Less by default: fewer fields, fewer knobs, fewer distractions.
Avoid feature creep: we prioritize clarity over clutter.

Don't show me a cockpit when I just want to ride a bike.

Features

GTD workflow end-to-end: Capture, Clarify, Organize, Reflect, Engage.
Focus view combines time-based agenda with next actions.
Local-first data model with native iCloud / CloudKit sync on supported Apple builds, plus file sync, WebDAV, Dropbox, and self-hosted cloud options.
Projects support sections, areas, and reorderable project task order for larger multi-step planning.
Obsidian vault import with note deep links on desktop.
Optional AI copilot (BYOK + local/self-hosted compatible models).
Cross-platform apps for desktop and mobile, plus PWA.
Optional automation helpers with desktop local REST API, CLI, and the published mindwtr-mcp server.

<details> <summary>See all features</summary>

GTD Workflow

Capture - Quick add tasks from anywhere (global hotkey popup, tray, share sheet, voice)
Clarify - Guided inbox processing with 2-minute rule
Organize - Projects, sections, contexts, and status lists
Reflect - Weekly review wizard with reminders
Engage - Context-filtered next actions
AI Assist (Optional) - Clarify, break down, and review with BYOK AI (OpenAI, Gemini, Claude, or local/self-hosted OpenAI-compatible LLMs)

Views

📥 Inbox - Capture zone with processing wizard
🎯 Focus - Agenda (time-based) + Next Actions in one view
📁 Projects - Multi-step outcomes with sections, areas, and manual task ordering
🏷️ Contexts - Slash-delimited contexts with parent matching (@work/meetings)
⏳ Waiting For - Delegated items
💭 Someday/Maybe - Deferred ideas
📅 Calendar - Time-based planning with adjustable mobile week density
📋 Board - Kanban-style drag-and-drop
📝 Review - Daily + weekly review workflows
📦 Archived - Hidden history, searchable when needed

Productivity Features

🔍 Global Search - Search all areas globally with operators (status:, context:, assigned:, location:, where:, id:, -id:, due:<=7d)
📦 Bulk Actions - Multi-select, batch move/tag/delete
📎 Attachments - Files and links on tasks
✏️ Markdown Notes - Rich text descriptions with preview
🗂️ Project States - Active, Waiting, Someday, Archived
♾️ Fluid Recurrence - Next date is calculated after completion
♻️ Reusable Lists - Duplicate tasks or reset checklists
✅ Checklist Mode - Fast list-style checking for checklist tasks
✅ Audio Capture - Quick voice capture with automatic transcription and task creation
🧭 Copilot Suggestions - Optional context/tag/time hints while typing
🍅 Pomodoro Focus (Optional) - 15/3, 25/5, 50/10 timer panel in Focus view with one optional custom preset
🔔 Notifications - Separate start and due reminders with snooze
📊 Daily Digest - Morning briefing + evening review
📅 Weekly Review - Customizable weekly reminder

Data & Sync

🔄 Sync Options - See the Data & Sync docs for supported backends and setup
🍎 Native iCloud / CloudKit Sync - Apple-only structured sync on supported iPhone, iPad, and macOS builds
☁️ Dropbox OAuth Sync (Optional) - Native Dropbox App Folder sync in supported non-FOSS builds
📤 Export/Backup - Export data to JSON
♻️ Restore from Backup - Replace local data from a validated Mindwtr backup with a recovery snapshot first
📥 TickTick + Todoist + DGT GTD + OmniFocus + Apple Reminders Import - Import TickTick CSV/ZIP, Todoist CSV/ZIP, DGT GTD JSON/ZIP, OmniFocus exports, or incomplete Apple Reminders into Mindwtr
🔗 Obsidian Integration - Desktop vault task import with deep links back to source notes
🗓️ External Calendars (System + ICS) - Mobile reads system calendars and pushes dated tasks; macOS desktop reads Apple Calendar and can push dated tasks; desktop/web also support ICS subscriptions and task creation from events

Automation

🔌 CLI - Add, list, complete, search from terminal by running the repo helper
🌐 REST API - Optional desktop localhost API server for token-authenticated scripting
🌍 Web App (PWA) - Browser access with offline support
🧠 MCP Server - Optional local stdio Model Context Protocol server for LLM automation, available as mindwtr-mcp and in the MCP Registry

Desktop builds can start the local REST API from Settings -> Advanced on 127.0.0.1 with default port 3456 and a generated bearer token. The CLI remains a repo helper; the stdio MCP server can be installed from npm with npm install -g mindwtr-mcp or launched by MCP clients with npx -y mindwtr-mcp.

Cross-Platform

🖥️ Desktop - Tauri v2 (macOS, Linux, Windows)
📱 Mobile - React Native/Expo (iOS via App Store/TestFlight, Android) with in-app tips for gestures and app shortcuts
📲 Android Widget - Home screen focus/next widget
⌨️ Keyboard Shortcuts - Vim and Emacs presets
🎨 Themes - Light/Dark
🌍 i18n - English, Vietnamese, Chinese (Simplified), Chinese (Traditional), Spanish, Hindi, Arabic, German, Russian, Japanese, French, Portuguese, Polish, Korean, Czech, Italian, Turkish, Dutch
🐳 Docker - Run the PWA + self-hosted sync server with Docker

</details>

Installation

For the complete and current install guides, see Desktop Installation and Mobile Installation.

Quick options:

Windows: Microsoft Store, Winget, Chocolatey, Scoop, or GitHub Releases.
macOS: Mac App Store, Homebrew, TestFlight beta, or GitHub Releases.
Linux: Flathub, Snap, AUR, APT/RPM repos, or GitHub Releases.
Android: Google Play, F-Droid, IzzyOnDroid, or GitHub Releases APK.
iOS: App Store or TestFlight beta.
Web / self-hosted: Cloud Deployment or the Docker guide.

<details> <summary>Package manager quick commands</summary>

flatpak install flathub tech.dongdongbh.mindwtr
yay -S mindwtr-bin
brew install --cask mindwtr

winget install dongdongbh.Mindwtr

For APT/RPM repo setup, source builds, portable ZIPs, mobile store variants, and Docker setup, use the full install guides above.

</details>

Community

Mindwtr is shaped by its users and contributors. Thank you for helping improve it.

:hearts: Contributing & Support

If you want to get involved, start with CONTRIBUTING.md.

You can help in several ways:

Spread the word: Share Mindwtr with friends and communities, and support it on Product Hunt and AlternativeTo.
Leave store reviews: A good rating/review on the App Store, Google Play, or Microsoft Store helps a lot.
Star and share: Star the repo and post about Mindwtr on X, Reddit, or LinkedIn.
Report bugs and request features: Open issues on GitHub Issues.
Join the community chat: Come to Discord.
Help with translations: Contribute locale updates in packages/core/src/i18n/locales/.
Contribute code/docs: Open a pull request and follow the contribution guide and commit conventions.
Pick and build: Community members are welcome to pick any open issue and submit a PR.
Sponsor the project: Support ongoing development via GitHub Sponsors or Ko-fi.

Documentation

📚 Official Docs - Searchable documentation with better navigation
🚀 Getting Started
❓ FAQ
🔄 Data & Sync
🔗 Markdown Links
🛠️ Cloud Deployment
☁️ Cloud API
🧠 MCP Server
📝 Release Notes Index

Star History

View repository →