# Callosium

Connects your AI assistants to a single memory stored in local Markdown files. Keeps your notes private and stops repetitive project explanations.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11
- Author: callosium
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/callosium/callosium
- Updated: 2026-08-30
- HTML: https://affpapa.org/en/nevibecode/mcp/callosium

## What it does

Callosium turns local Markdown notes or an Obsidian vault into a shared knowledge base for coding assistants. When asked a question, connected clients query this local memory first and cite the exact source files. If the answer is missing from your notes, the tool avoids guesswork and states that fact directly.

The architecture runs locally through a dashboard at `http://localhost:4319`. You control folder access per agent. The engine also signs every file update with the identity of the AI that wrote it.

Node.js 20 or newer is required. On its initial start, the tool fetches a 120MB model for English and Arabic semantic search. If no network connection is available, keyword matching continues to function on its own.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `CALLOSIUM_MODEL_DIR` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env CALLOSIUM_MODEL_DIR=<CALLOSIUM_MODEL_DIR> --transport stdio callosium -- npx -y callosium
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add callosium --env CALLOSIUM_MODEL_DIR=<CALLOSIUM_MODEL_DIR> -- npx -y callosium
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "callosium": {
            "command": "npx",
            "args": [
                "-y",
                "callosium"
            ],
            "env": {
                "CALLOSIUM_MODEL_DIR": "<CALLOSIUM_MODEL_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "callosium": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "callosium"
            ],
            "env": {
                "CALLOSIUM_MODEL_DIR": "<CALLOSIUM_MODEL_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e CALLOSIUM_MODEL_DIR=<CALLOSIUM_MODEL_DIR> callosium npx -y callosium
```
Replace <…> with your own values

## When to use it
- share project context across different AI editors and chat apps
- connect local Obsidian vaults directly to coding assistants
- restrict specific folders from being viewed by selected agents
- verify statements through exact citations from local notes

## Example prompts
- Look up our database deployment steps in my local notes
- Save the agreed API endpoint design into the project notes folder
- Check the vault for broken links and orphan files

## Similar
- [context-mem](https://affpapa.org/en/nevibecode/mcp/context-mem.md) — MCP server · ★ 19
- [Global Agent Memory](https://affpapa.org/en/nevibecode/mcp/global-agent-memory.md) — MCP server · ★ 14
- [sqlite-graph-memory](https://affpapa.org/en/nevibecode/mcp/sqlite-graph-memory.md) — MCP server · ★ 12
- [oh-my-obsidian](https://affpapa.org/en/nevibecode/plugins/oh-my-obsidian.md) — plugin · ★ 33
- [openclaw-history-ingest](https://affpapa.org/en/nevibecode/skills/openclaw-history-ingest.md) — skill · 2200 installs
- [llm-wiki](https://affpapa.org/en/nevibecode/skills/ar9av-llm-wiki.md) — skill · 4100 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