PluginBench
MCP Server
Active
AGPL-3.0

Mindwtr MCP Server

io.github.dongdongbh/mindwtr

Free, open-source GTD app with local-first data and MCP automation support.

RepositoryRegistry
How to choose

What this kind of tool is for

  • Chain multi-step workflows across the other tools in this directory.
  • Run a scheduled or triggered job instead of retyping the same request.
  • Have your agent watch a feed, queue, or repo and act on new items.

How to compare servers like this

Trigger model:
Understand what starts the automation — a command, a schedule, or an event — before relying on it.
Blast radius:
Prefer tools that hand you a review point before an irreversible action runs.
Chaining cost:
Each chained step adds a failure point; keep critical paths on the fewest tools.
Maintenance signal:
Automations break quietly; a maintained tool is the difference between repair and rediscovery.

This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.

What is the Mindwtr MCP server?

The Mindwtr MCP server enables task and project automation for Mindwtr, a free, open-source Getting Things Done (GTD) application with local-first data storage. It provides read-only access by default to Mindwtr's local and self-hosted cloud data, allowing AI agents to query and interact with tasks, projects, and contexts.

Mindwtr MCP server integrates with Mindwtr's GTD system to enable AI-powered task automation and querying. It's designed for users who want to automate task management workflows, generate reports, or have Claude and other AI agents interact with their task data without requiring account authentication. The server operates locally or against self-hosted Mindwtr instances.

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 Cloud mode.

  • MINDWTR_MCP_CLOUD_TOKEN

    Bearer token for self-hosted Mindwtr Cloud mode.

~/Library/Application Support/Claude/claude_desktop_config.json
JSON config
{
  "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>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

  • Task Query — Read and search tasks from Mindwtr with support for filtering by status, context, project, and other criteria
  • Project Management — Access project information, sections, and task organization
  • Context Filtering — Query tasks by contexts and slash-delimited context hierarchies
  • Inbox Processing — Interact with captured tasks in the inbox
  • Status and Metadata Access — Retrieve task metadata including due dates, recurrence, attachments, and notes

Use cases

  • Automate daily task summaries and weekly review reports from your Mindwtr inbox
  • Query next actions by context to generate focused work lists for AI planning
  • Integrate Mindwtr tasks with other automation tools via the MCP protocol
  • Generate task breakdowns and clarifications using AI based on your project data
  • Create custom task filtering and reporting workflows without leaving your AI assistant

Mindwtr MCP server FAQ

What is the Mindwtr MCP server?

It's a Model Context Protocol server that connects Mindwtr (a free, open-source GTD app) to AI agents like Claude, enabling automation and querying of tasks and projects. It's read-only by default for safety.

Is Mindwtr free?

Yes, Mindwtr is completely free and open-source with no account required. It's local-first and supports optional self-hosted or cloud sync.

How do I install the MCP server?

Install via npm with `npm install -g mindwtr-mcp` or run with `npx -y mindwtr-mcp`. Then configure it in your MCP client (Cursor, Claude, etc.) to connect to your local Mindwtr instance.

Do I need authentication to use it?

No account is required. The server connects to your local Mindwtr data or self-hosted instance directly. Desktop builds can enable the local REST API from Settings > Advanced.

What platforms does Mindwtr support?

Mindwtr runs on macOS, Linux, Windows, iOS, Android, and as a web app (PWA). The MCP server works on any platform with Node.js.

Can I write tasks with this MCP server?

The MCP server is read-only by default for safety. Check the official MCP documentation for any write capabilities or configuration options.

README (reference)

Source of truth, from the repository.

<div align="center"> <img src="apps/mobile/assets/images/icon.png" width="120" alt="Mindwtr Logo">

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

CI GitHub license GitHub downloads Ask DeepWiki Discord GitHub Sponsors Ko-fi

<p align="center" style="text-align: center;"> <a href="https://apps.microsoft.com/detail/9n0v5b0b6frx?ocid=webpdpshare" target="_blank"> <img src="https://developer.microsoft.com/store/badges/images/English_get-it-from-MS.png" align="center" alt="Microsoft Store" style="height: 50px" height="50" /> </a> <a href="https://play.google.com/store/apps/details?id=tech.dongdongbh.mindwtr" target="_blank"> <img src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png" align="center" alt="Google Play" style="height: 74px" height="74" /> </a> <a href="https://apps.apple.com/app/mindwtr/id6758597144" target="_blank"> <img src="https://tools.applemediaservices.com/api/badges/download-on-the-app-store/black/en-us?size=250x83" align="center" alt="App Store" style="height: 50px" height="50" /> </a> <a href="https://flathub.org/apps/tech.dongdongbh.mindwtr" target="_blank"> <img alt="Get it on Flathub" src="https://flathub.org/api/badge?locale=en" align="center" style="height: 50px" height="50" /> </a> <a href="https://apt.izzysoft.de/packages/tech.dongdongbh.mindwtr" target="_blank"> <img src="https://gitlab.com/IzzyOnDroid/repo/-/raw/master/assets/IzzyOnDroid.png" align="center" alt="Get it at IzzyOnDroid" style="height: 74px" height="74" /> </a> <a href="https://f-droid.org/en/packages/tech.dongdongbh.mindwtr/" target="_blank"> <img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" align="center" alt="Get it on F-Droid" style="height: 74px" height="74" /> </a> <a href="https://snapcraft.io/mindwtr" target="_blank"> <img alt="Get it from the Snap Store" src="https://snapcraft.io/en/dark/install.svg" align="center" style="height: 50px" height="50" /> </a> </p> </div> <div align="center"> <video src="https://github.com/user-attachments/assets/e62ac128-467d-4e2f-beb0-7fc3c947bfeb" width="60%" autoplay loop muted playsinline></video>

<video src="https://github.com/user-attachments/assets/d6688a01-989f-41b9-b190-94b21b0ae821" width="25%" autoplay loop muted playsinline></video>

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

CapabilityMindwtrTodoistTickTickEverdoNirvanaHQ
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:

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

Documentation

Star History

<a href="https://www.star-history.com/?repos=dongdongbh%2FMindwtr&type=date&legend=top-left"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=dongdongbh/Mindwtr&type=date&theme=dark&legend=top-left" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=dongdongbh/Mindwtr&type=date&legend=top-left" /> <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=dongdongbh/Mindwtr&type=date&legend=top-left" /> </picture> </a>

Sponsors

Thanks to these monthly sponsors for supporting Mindwtr.

<p align="center"> <a href="https://github.com/jarrydstan" title="@jarrydstan"> <img src="docs/assets/sponsors/jarrydstan.png" width="60" height="60" alt="@jarrydstan" /> </a> <a href="https://github.com/ronmolenda" title="@ronmolenda"> <img src="docs/assets/sponsors/ronmolenda.png" width="60" height="60" alt="@ronmolenda" /> </a> <a href="https://github.com/bepolymathe" title="@bepolymathe"> <img src="docs/assets/sponsors/bepolymathe.png" width="60" height="60" alt="@bepolymathe" /> </a> <a href="https://github.com/karl1990" title="@karl1990"> <img src="docs/assets/sponsors/karl1990.png" width="60" height="60" alt="@karl1990" /> </a> <a href="https://github.com/srijan" title="@srijan"> <img src="docs/assets/sponsors/srijan.png" width="60" height="60" alt="@srijan" /> </a> <a href="https://github.com/davibicudo" title="@davibicudo"> <img src="docs/assets/sponsors/davibicudo.png" width="60" height="60" alt="@davibicudo" /> </a> </p> <p align="center"> <sub><a href="https://github.com/jarrydstan">@jarrydstan</a> · <a href="https://github.com/ronmolenda">@ronmolenda</a> · <a href="https://github.com/bepolymathe">@bepolymathe</a> · <a href="https://github.com/karl1990">@karl1990</a> · <a href="https://github.com/srijan">@srijan</a> · <a href="https://github.com/davibicudo">@davibicudo</a></sub> </p>

Related MCP servers

MCP server for CDEK delivery service API — create orders, track shipments, search delivery points

0
Python
View repository →

MCP server for Ozon Seller API — products, FBS/FBO, finance, analytics, returns

2
Python
MIT
View repository →

MCP server for Yandex Direct API v5 — campaigns, ads, keywords, bids, audiences

0
Python
View repository →

AI task cockpit: an agent does your tasks and asks before anything irreversible.

0
MIT
View repository →

Python code intelligence for coding agents: call paths, control flow, and change impact.

2
Python
MIT
View repository →

Associative key-graph memory for LLM agents — recall by association, not vector similarity.

1
TypeScript
MIT
View repository →