Mindwtr MCP Server
io.github.dongdongbh/mindwtr
Free, open-source GTD app with local-first data and MCP automation support.
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.
MINDWTR_DB_PATHOptional path to the local Mindwtr SQLite database.
MINDWTR_MCP_CLOUD_URLOptional self-hosted Mindwtr Cloud base URL for Cloud mode.
MINDWTR_MCP_CLOUD_TOKENBearer token for self-hosted Mindwtr Cloud mode.
{
"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 criteriaProject Management— Access project information, sections, and task organizationContext Filtering— Query tasks by contexts and slash-delimited context hierarchiesInbox Processing— Interact with captured tasks in the inboxStatus 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
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.
Yes, Mindwtr is completely free and open-source with no account required. It's local-first and supports optional self-hosted or cloud sync.
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.
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.
Mindwtr runs on macOS, Linux, Windows, iOS, Android, and as a web app (PWA). The MCP server works on any platform with Node.js.
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.
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 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.
| 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-mcpserver.
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-mcpand 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
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.
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
<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

io.github.dontsovcmc/cdek
MCP server for CDEK delivery service API — create orders, track shipments, search delivery points

io.github.dontsovcmc/ozon-seller
MCP server for Ozon Seller API — products, FBS/FBO, finance, analytics, returns

io.github.dontsovcmc/yandex-direct
MCP server for Yandex Direct API v5 — campaigns, ads, keywords, bids, audiences
AI task cockpit: an agent does your tasks and asks before anything irreversible.

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

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