Skip to content
MCP server

mindin

Markdown notes vault with indexed search, schema-checked writes and git-linked memory

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Web
Runs
Locally
Version
0.21.1
Listing updated
today

Similar MCP servers

About mindin

mindin is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • VAULT_PATHDirectory holding the vault. Set this or the four S3_* variables.
  • S3_ENDPOINTS3 or MinIO endpoint URL holding the vault
  • S3_ACCESS_KEYAccess key for the vault bucket
  • S3_SECRET_KEYSecret key for the vault bucket
  • S3_BUCKETBucket holding the vault
  • S3_PREFIXKey prefix inside the bucket
  • S3_REGIONRegion for the vault bucket
  • VAULT_CACHE_DIRWhere the SQLite index lives
  • VAULT_SCHEMALocal schema file overriding the one in the vault
  • VAULT_STOP_HOOKSet to off to disable the stop hook
  • VAULT_STOP_HOOK_COMMITSSet to off to turn off the stop hook's unlogged-commit and stale-note checks alone
  • VAULT_STOP_HOOK_PROMPTSMessages the user writes after the agent's last vault write before the stop hook asks it to save them (default 3), or off

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

MIT; free to self-host

mindin 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.

How AIPoweredBot checks servers