# Mindwtr

> Mindwtr is an open-source MCP server for productivity. Read and edit your Mindwtr tasks from Claude, Codex or Gemini, read-only by default. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, self-hosted, CLI
- **Website:** https://docs.mindwtr.app/power-users/mcp
- **Repository:** https://github.com/dongdongbh/mindwtr/tree/HEAD/apps/mcp-server
- **MCP Registry name:** io.github.dongdongbh/mindwtr
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `mindwtr_archive_task`: Archives a task without completing it or generating its next recurrence.

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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/mindwtr
