Mindwtr
Read and edit your Mindwtr tasks from Claude, Codex or Gemini, read-only by default
- Pricing
- Open source
- Platforms
- macOS, Windows, Linux
- Runs
- Locally
- Version
- 1.1.14
- Listing updated
- 3 days ago
About Mindwtr
Mindwtr is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
Edits are off until you switch them on. In the desktop app's built-in server, MCP is disabled and read-only by default, and permissions are separate switches: task and project edits, then archiving and deletion under Advanced, all starting off on a new install. Deletion is soft, and the mindwtr_archive_task tool archives without completing a task or creating its next recurrence.
There are two ways in. The desktop app can host a Streamable HTTP server at http://127.0.0.1:8722/mcp, always bound to localhost and protected by a bearer token, with a button that copies the Codex configuration. Alternatively the standalone mindwtr-mcp helper runs over stdio and can point at the local SQLite database, the desktop Local API or a self-hosted Mindwtr Cloud endpoint, set by environment variables. It needs Node.js 20 or newer, and Node 22 is preferred for prebuilt SQLite binaries.
Mobile apps do not host MCP, and the local endpoint gives no remote ChatGPT access. The docs warn that connected AI clients can read the exposed data and may send it to their provider.
Install
Run in a terminal
claude mcp add mindwtr --env MINDWTR_MCP_CLOUD_TOKEN='<MINDWTR_MCP_CLOUD_TOKEN>' --env MINDWTR_MCP_API_TOKEN='<MINDWTR_MCP_API_TOKEN>' -- npx -y mindwtr-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mindwtr": {
"command": "npx",
"args": [
"-y",
"mindwtr-mcp"
],
"env": {
"MINDWTR_MCP_CLOUD_TOKEN": "<MINDWTR_MCP_CLOUD_TOKEN>",
"MINDWTR_MCP_API_TOKEN": "<MINDWTR_MCP_API_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mindwtr": {
"command": "npx",
"args": [
"-y",
"mindwtr-mcp"
],
"env": {
"MINDWTR_MCP_CLOUD_TOKEN": "<MINDWTR_MCP_CLOUD_TOKEN>",
"MINDWTR_MCP_API_TOKEN": "<MINDWTR_MCP_API_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mindwtr": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mindwtr-mcp"
],
"env": {
"MINDWTR_MCP_CLOUD_TOKEN": "<MINDWTR_MCP_CLOUD_TOKEN>",
"MINDWTR_MCP_API_TOKEN": "<MINDWTR_MCP_API_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mindwtr": {
"command": "npx",
"args": [
"-y",
"mindwtr-mcp"
],
"env": {
"MINDWTR_MCP_CLOUD_TOKEN": "<MINDWTR_MCP_CLOUD_TOKEN>",
"MINDWTR_MCP_API_TOKEN": "<MINDWTR_MCP_API_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mindwtr": {
"command": "npx",
"args": [
"-y",
"mindwtr-mcp"
],
"env": {
"MINDWTR_MCP_CLOUD_TOKEN": "<MINDWTR_MCP_CLOUD_TOKEN>",
"MINDWTR_MCP_API_TOKEN": "<MINDWTR_MCP_API_TOKEN>"
}
}
}
}Configuration
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.MINDWTR_MCP_API_URLDesktop Local API origin, e.g. http://127.0.0.1:3456. Selects API mode.MINDWTR_MCP_API_TOKENBearer token from the desktop Local API settings; required in API mode.
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- mindwtr_archive_task
- Archives a task without completing it or generating its next recurrence.
What it does
- Read-only by default
- Edits, archiving and deletion are separate permissions that all start off.
- Built-in desktop server
- Runs inside the app on localhost with a bearer token and a configurable port.
- Standalone stdio helper
- mindwtr-mcp connects clients to SQLite, the Local API or Mindwtr Cloud.
- Archive tool
- mindwtr_archive_task archives without completing or recurring.
- Codex config copy
- One button copies the TOML for a Codex client.
- Soft deletion
- Deleted tasks are soft-deleted rather than removed outright.
Good for
- Ask an agent what is due this week
- Let an assistant create and complete tasks with permission
- Review projects from Claude Code
- Automate task changes against a self-hosted Mindwtr Cloud
- Archive finished work from a chat
Pricing
Open source
Prices change. Check docs.mindwtr.app before you buy.
Mindwtr FAQ
Can the agent change my tasks?
Only if you enable task and project edits. Archiving and deletion need their own switches.
Where does the desktop server listen?
On 127.0.0.1, port 8722 by default, configurable from 1024 to 65535.
Do mobile apps support it?
No. Mobile apps do not host an MCP server.
What does the helper need?
Node.js 20 or newer, with Node 22 preferred for prebuilt SQLite binaries.
Is Mindwtr free?
Yes. Mindwtr is open source, so you can use and self-host it for free.
How do I add Mindwtr to Claude Code?
Run this command in your terminal: claude mcp add mindwtr --env MINDWTR_MCP_CLOUD_TOKEN='<MINDWTR_MCP_CLOUD_TOKEN>' --env MINDWTR_MCP_API_TOKEN='<MINDWTR_MCP_API_TOKEN>' -- npx -y mindwtr-mcp
What are the best alternatives to Mindwtr?
The closest alternatives to Mindwtr are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.
Alternatives to Mindwtr

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media