# Mindwtr (MCP server)

> Mindwtr is an MCP server that adds database tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Task automation via SQLite, desktop Local API, or Mindwtr Cloud; read-only by default. It has 2,211 GitHub stars, is released under the AGPL-3.0 license and runs locally with npx -y mindwtr-mcp.

MCP server for Mindwtr. Connect MCP clients (Claude Desktop, etc.) to your local SQLite database, the desktop Local API, or a self-hosted Mindwtr Cloud endpoint.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/dongdongbh/Mindwtr |
| GitHub stars | 2,211 |
| License | AGPL-3.0 |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: mindwtr-mcp |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Databases |
| Latest release | v1.3.4 (Oct 5, 2026) |
| Last commit | Oct 7, 2026 |
| MCP registry name | io.github.dongdongbh/mindwtr |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mindwtr": {
      "command": "npx",
      "args": [
        "-y",
        "mindwtr-mcp"
      ],
      "env": {
        "MINDWTR_MCP_CLOUD_TOKEN": "your-value",
        "MINDWTR_MCP_API_TOKEN": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env MINDWTR_MCP_CLOUD_TOKEN=your-value --env MINDWTR_MCP_API_TOKEN=your-value --transport stdio mindwtr -- npx -y mindwtr-mcp
```

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

```json
{
  "mcpServers": {
    "mindwtr": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mindwtr-mcp"
      ],
      "env": {
        "MINDWTR_MCP_CLOUD_TOKEN": "your-value",
        "MINDWTR_MCP_API_TOKEN": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

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

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "mindwtr_mcp_cloud_token",
      "description": "MINDWTR_MCP_CLOUD_TOKEN",
      "password": true
    },
    {
      "type": "promptString",
      "id": "mindwtr_mcp_api_token",
      "description": "MINDWTR_MCP_API_TOKEN",
      "password": true
    }
  ],
  "servers": {
    "mindwtr": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mindwtr-mcp"
      ],
      "env": {
        "MINDWTR_MCP_CLOUD_TOKEN": "${input:mindwtr_mcp_cloud_token}",
        "MINDWTR_MCP_API_TOKEN": "${input:mindwtr_mcp_api_token}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `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` (secret): Bearer token for self-hosted Mindwtr Cloud mode.
- `MINDWTR_MCP_API_URL`: Desktop Local API origin, e.g. http://127.0.0.1:3456. Selects API mode.
- `MINDWTR_MCP_API_TOKEN` (secret): Bearer token from the desktop Local API settings; required in API mode.

## Tools

- `mindwtr_list_tasks`
- `view`: narrows by GTD availability: available, deferred or blocked
- `mindwtr_list_projects`
- `mindwtr_get_project`
- `mindwtr_list_sections`
- `mindwtr_get_section`
- `mindwtr_list_areas`
- `mindwtr_list_people`
- `mindwtr_get_person`
- `mindwtr_get_task`
- `mindwtr_add_task`: (requires --write)
- `mindwtr_update_task`: (requires --write)
- `recurrence`: accepts a recurrence object or an RFC 5545 RRULE string. Pass null to clear it.
- `attachments`: holds link attachments only ({ id?, title?, uri }, e.g. obsidian://, file:// or https://).
- `mindwtr_complete_task`: (requires --write)
- `mindwtr_delete_task`: (requires --write)
- `mindwtr_restore_task`: (requires --write)
- `mindwtr_add_project`: (requires --write)
- `mindwtr_update_project`: (requires --write)
- `mindwtr_delete_project`: (requires --write)
- `mindwtr_add_section`: (requires --write)
- `mindwtr_update_section`: (requires --write)
- `mindwtr_delete_section`: (requires --write)
- `mindwtr_add_area`: (requires --write)
- `mindwtr_update_area`: (requires --write)
- `mindwtr_delete_area`: (requires --write)
- `mindwtr_add_person`: (requires --write)
- `mindwtr_update_person`: (requires --write)
- `mindwtr_rename_person`: (requires --write)
- `mindwtr_delete_person`: (requires --write)

## Similar MCP servers

- [Dbx](https://appsgit.com/mcp-servers/dbx): Query databases from AI agents using connections configured in DBX. (24,945 stars, Apache-2.0)
- [Butterbase AI MCP Server](https://appsgit.com/mcp-servers/butterbase-ai-mcp-server): Butterbase MCP server — manage your backend: schemas, auth, functions, storage, RAG, deploys. (3,686 stars, Apache-2.0, needs API key)
- [DBHub](https://appsgit.com/mcp-servers/dbhub): Token-efficient database MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite. (3,610 stars, MIT, needs API key)
- [LINQ to DB](https://appsgit.com/mcp-servers/linq-to-db): Inspect database schemas and execute SQL queries across multiple database providers with LINQ to DB. (3,332 stars, MIT)
- [MCP Memory Service](https://appsgit.com/mcp-servers/mcp-memory-service): Open-source persistent memory for AI agent pipelines (LangGraph, CrewAI, AutoGen) and Claude. (1,988 stars, Apache-2.0)
- [Pg Aiguide](https://appsgit.com/mcp-servers/pg-aiguide): Comprehensive PostgreSQL documentation and best practices, including ecosystem tools. (1,857 stars, Apache-2.0, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/mindwtr
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.