mindin
Markdown notes vault with indexed search, schema-checked writes and git-linked memory
- 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 mindinAdd 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 vaultS3_ACCESS_KEYAccess key for the vault bucketS3_SECRET_KEYSecret key for the vault bucketS3_BUCKETBucket holding the vaultS3_PREFIXKey prefix inside the bucketS3_REGIONRegion for the vault bucketVAULT_CACHE_DIRWhere the SQLite index livesVAULT_SCHEMALocal schema file overriding the one in the vaultVAULT_STOP_HOOKSet to off to disable the stop hookVAULT_STOP_HOOK_COMMITSSet to off to turn off the stop hook's unlogged-commit and stale-note checks aloneVAULT_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.



