# atlas-mind

atlas-mind is an MCP server for Claude Code that connects a git-backed local knowledge base. Your AI assistant reads notes, edits files, and audits changes.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: Anakior
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Anakior/atlas-mind
- Updated: 2026-06-30
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/atlas-mind

## What it does

atlas-mind serves a private wiki from a directory backed by git. Notes remain plain files on local storage rather than in a cloud database. The web viewer renders Markdown, inspects PDF files, and previews HTML decks or Word .docx files inside the browser.

Through the MCP interface, your assistant gains direct access to your knowledge base. It can search records, add new documents, update backlinks when paths shift, and inspect past git commits. Running `atlas init` automatically creates directory conventions for agent instructions and chat logs.

The web engine runs on Python standard library and makes no network requests outside your machine. Running it requires Python 3.11 and an initialized git repository. Without that Python version, the CLI fails to start.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://{ATLAS_MCP_URL}`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http atlas-mind https://{ATLAS_MCP_URL}
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add atlas-mind --url https://{ATLAS_MCP_URL}
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "atlas-mind": {
            "url": "https://{ATLAS_MCP_URL}"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "atlas-mind": {
            "type": "http",
            "url": "https://{ATLAS_MCP_URL}"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http atlas-mind https://{ATLAS_MCP_URL}
```

## When to use it
- store documentation in a personal git repository
- let an assistant read and update notes via MCP
- trace document revision history through git commits
- collect agent-generated drafts into an inbox for review
- spot conflicting points across related articles

## Example prompts
- Search my documentation for deployment instructions and summarize key steps.
- Create a reference page for our API routes and link it to the index document.
- Show the recent git changes for the architecture guide using doc_diff.

## Similar
- [llm-wiki](https://affpapa.org/en/nevibecode/skills/hermes-agent-llm-wiki.md) — skill · 625 installs
- [second-brain](https://affpapa.org/en/nevibecode/skills/coreyhaines31-second-brain.md) — skill · 412 installs
- [company-brain](https://affpapa.org/en/nevibecode/skills/company-brain.md) — skill · 407 installs
- [beever-atlas](https://affpapa.org/en/nevibecode/mcp/beever-atlas.md) — MCP server · ★ 454 repo stars
- [kObsidian](https://affpapa.org/en/nevibecode/mcp/kobsidian.md) — MCP server · ★ 9 repo stars
- [karpathy-llm-wiki](https://affpapa.org/en/nevibecode/skills/karpathy-llm-wiki.md) — skill · 8900 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
