Mindwtr
Task automation via SQLite, desktop Local API, or Mindwtr Cloud; read-only by default.
Mindwtr
Get everything out of your head.
A free to-do app built on Getting Things Done (GTD). Works offline, no account needed.
30,000+ users · Windows · macOS · Linux · iOS · Android
Download · Features · Docs · 中文
Capture, organize, and focus on desktop & mobile
How it works
Start with whatever is on your mind, from "plan Mom's birthday" to "learn guitar someday." Mindwtr guides you through what to do with it. You don't need to learn GTD first.
- Capture it. Send tasks and ideas to your Inbox with a desktop shortcut, phone widget, or share sheet.
- Choose a next step. Break a bigger plan into actions, track promises in Waiting For, and keep future ideas in Someday/Maybe.
- Pick something to do. Open Focus for today's schedule and your next actions. Filter by where you are or the tools you have with you.
- Review each week. Follow the guided review to check your projects, follow up on waiting items, and catch loose ends.
All videos on the website · YouTube channel
For more about the method, read GTD in 15 minutes or explore the interactive GTD flowchart.
Highlights
- GTD from capture to review. Work through your Inbox, plan projects, and follow a guided weekly review to keep both your next steps and longer-term plans in view.
- Your data stays yours. Keep tasks on your device, work offline, and export a backup. Sync is optional: choose iCloud, Dropbox, a shared folder, WebDAV, or your own server.
- The same workflow on your phone and computer. Use the full GTD workflow on Windows, macOS, Linux, iPhone, iPad, and Android, with 23 language options.
- Bring your existing tasks. Import from Todoist, TickTick, OmniFocus, and more so you can start with the plans you've already made.
- Add the tools you need. Plan with a calendar, set up recurring tasks, and keep notes and attachments with your work. AI assistance is off by default and yours to enable.
The name Mindwtr comes from mind like water: write down what’s on your mind so you can give your attention to the task at hand.
Mindwtr is built for your personal tasks. Start with a simple list and use more options as you need them. There are no streaks or productivity scores to keep up with.
Why Mindwtr (Quick Comparison)
Mindwtr is for people who want the full GTD method in one app, with data they own and no lock-in. Here is how it compares with a few other to-do apps.
| Capability | Mindwtr | Todoist | TickTick | Everdo | NirvanaHQ |
|---|---|---|---|---|---|
| Open source | ✅ | ❌ | ❌ | ❌ | ❌ |
| Follows the full GTD method out of the box | ✅ | ⚠️ | ⚠️ | ✅ | ✅ |
| Works everywhere: Windows, Mac, Linux, iPhone, Android, web | ✅ | ✅ | ✅ | ⚠️ | ⚠️ |
| Wearable support (smartwatches or smart rings) | ✅ | ✅ | ✅ | ❌ | ❌ |
| Works offline, no account needed | ✅ | ❌ | ❌ | ✅ | ❌ |
| Optional AI helper (your own AI account, or one on your computer) | ✅ | ❌ | ❌ | ❌ | ❌ |
| You pick where your data syncs (Dropbox, your server, a folder, WebDAV) | ✅ | ❌ | ❌ | ⚠️ | ❌ |
| 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.
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.
Windows builds: free code signing provided by SignPath.io, certificate by SignPath Foundation — application approved, certificate pending issuance. See the code signing policy.
Package manager quick commands
flatpak install flathub tech.dongdongbh.mindwtr
yay -S mindwtr-bin
brew install --cask mindwtr
# WinGet
winget install dongdongbh.Mindwtr
# Scoop (our own bucket, updated automatically on every release)
scoop bucket add mindwtr https://github.com/dongdongbh/homebrew-mindwtr
scoop install mindwtr
# Scoop alternative: the community-maintained Extras bucket
scoop bucket add extras
scoop install extras/mindwtr
For APT/RPM repo setup, source builds, portable ZIPs, mobile store variants, and Docker setup, use the full install guides above.
Developers & automation
Want to connect other tools? Explore the local API, the MCP server, or host the web app and sync server yourself. These are optional.
Community
Mindwtr is shaped by its users and contributors. Thank you for helping improve it.
:hearts: Contributing & Support
If you want to get involved for coding, 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.
Star History
Sponsors
Thanks to these monthly sponsors for supporting Mindwtr. Companies interested in sponsoring Mindwtr — README/website placement or partnerships — see SPONSORS.md.
Installation
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y mindwtr-mcpSet up in your AI client
Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-dongdongbh-mindwtr": {
"command": "npx",
"args": [
"-y",
"mindwtr-mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referencePackage
mindwtr-mcpnpmCompatible MCP Clients
Mindwtr works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
- Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect. - Cursor
~/.cursor/mcp.jsonRestart Cursor for changes to take effect. - VS Code
.vscode/mcp.jsonReload VS Code window for changes to take effect. - Windsurf
~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect. - Claude Code
.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.