# mindin

> mindin is an open-source MCP server for knowledge and memory. Markdown notes vault with indexed search, schema-checked writes and git-linked memory. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Web
- **Repository:** https://github.com/gronare/mindin
- **MCP Registry name:** io.github.gronare/mindin
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

Memory here is plain markdown that you own, kept in a folder or an S3 bucket and openable in Obsidian or git. A schema with required fields, legal statuses and kinds and a tag vocabulary makes the server refuse writes that break the contract, and you can start from PARA, a simple vault, a journal or your own layout.

A lifecycle layer adds tools: close archives finished work, backlog_add files deferred items, log_append writes one line per repo per session, and lint reports drift. A note can name the code paths it describes, so the session-start hook can print the commits newer than the note. Search handles stemming, folded diacritics and synonyms, with optional meaning-based search that runs on your machine.

For use across machines or in claude.ai, mindin can run a vault server via Docker Compose with passkey, email-link, GitHub or identity-provider sign-in, shared vaults and a team wiki for people on a company email domain, with a guard that refuses secrets. Anonymous usage data is only sent after you say yes. The package is MIT licensed and installs through uv.

## Features

- **Schema-enforced writes:** Refuses notes that break required fields, statuses or tag vocabulary.
- **Indexed multilingual search:** Handles stemming, diacritics and synonyms, with optional local semantic search.
- **Session lifecycle tools:** Closes finished work, files backlog items and logs one line per repo session.
- **Code-linked notes:** Shows commits newer than the note when a session starts.
- **Vault server:** Offers accounts, shared vaults and passkey or GitHub sign-in.
- **Portable vaults:** Moves a vault between a folder, a bucket and a server with file checks.

## Good for

- Keep long-term project memory for coding agents in markdown
- Flag notes that are stale compared with recent commits
- Share a team wiki with each person's Claude
- Search notes across languages
- Move a notes vault from local files to a server

## Install

### Claude Code (Terminal)

```sh
claude mcp add mindin --env S3_ACCESS_KEY='<S3_ACCESS_KEY>' --env S3_SECRET_KEY='<S3_SECRET_KEY>' -- uvx mindin
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mindin": {
      "command": "uvx",
      "args": [
        "mindin"
      ],
      "env": {
        "S3_ACCESS_KEY": "<S3_ACCESS_KEY>",
        "S3_SECRET_KEY": "<S3_SECRET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mindin": {
      "command": "uvx",
      "args": [
        "mindin"
      ],
      "env": {
        "S3_ACCESS_KEY": "<S3_ACCESS_KEY>",
        "S3_SECRET_KEY": "<S3_SECRET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mindin": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mindin"
      ],
      "env": {
        "S3_ACCESS_KEY": "<S3_ACCESS_KEY>",
        "S3_SECRET_KEY": "<S3_SECRET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mindin": {
      "command": "uvx",
      "args": [
        "mindin"
      ],
      "env": {
        "S3_ACCESS_KEY": "<S3_ACCESS_KEY>",
        "S3_SECRET_KEY": "<S3_SECRET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mindin": {
      "command": "uvx",
      "args": [
        "mindin"
      ],
      "env": {
        "S3_ACCESS_KEY": "<S3_ACCESS_KEY>",
        "S3_SECRET_KEY": "<S3_SECRET_KEY>"
      }
    }
  }
}
```

## Tools

- `close`: Archives finished work.
- `backlog_add`: Files deferred items in the backlog.
- `log_append`: Writes one line per repo per session.
- `lint`: Reports drift in the vault.

## FAQ

### Where are my notes stored?

As plain markdown in a folder or an S3 bucket, or on your own vault server.

### Does it send usage data?

Only after you agree; it then sends an anonymous install ID, version, OS and run mode, never notes or paths.

### Which agents can use it?

The installer offers to add it to Claude Code, Codex and Cursor, and a vault server connects to claude.ai.

### What is the license?

MIT.

### Is mindin free?

Yes. mindin is open source, so you can use and self-host it for free.

### How do I add mindin to Claude Code?

Run this command in your terminal: claude mcp add mindin --env S3_ACCESS_KEY='<S3_ACCESS_KEY>' --env S3_SECRET_KEY='<S3_SECRET_KEY>' -- uvx mindin

### What are the best alternatives to mindin?

The closest alternatives to mindin are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Concord MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [NeuroStack](https://ai-powered.com/mcp/neurostack): NeuroStack is a freemium MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.

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