mimir-memory-mcp 0.8.0

Mimir — structured memory MCP server for AI assistants

Mimir

Structured memory MCP server for LLMs.

Mimir provides persistent, structured memory for any LLM application via the Model Context Protocol. Multi-user, scope-based access control, tiered context loading, full-text search.

Named after Mímir, the Norse keeper of the Well of Wisdom.

Quick Start

pip

pip install mimir-mcp
MIMIR_DB_PATH=./mimir.db MIMIR_PORT=8100 mimir-mcp

Docker

docker run -p 8100:8100 -v mimir-data:/data mimir-mcp

From Source

git clone https://github.com/jimmy-larsson/mimir.git
cd mimir
pip install -e ".[dev]"
MIMIR_DB_PATH=./mimir.db mimir-mcp

Configuration

Environment Variable	Default	Description
MIMIR_DB_PATH	/data/mimir.db	SQLite database file path
MIMIR_PORT	8100	SSE transport port

Provisioning Users

Mimir uses API key authentication. Create users via SQL seed file:

INSERT INTO users (id, name, is_admin, api_key)
VALUES ('myuser', 'My User', TRUE, 'your-uuid-v4-api-key');

INSERT INTO scopes (id, name, description)
VALUES ('myuser', 'My User', 'Personal scope');

INSERT INTO scope_members (scope_id, user_id)
VALUES ('myuser', 'myuser');

INSERT INTO activity_cursor (user_id, last_seen_history_id)
VALUES ('myuser', 0);

Load it:

mimir-mcp seed --file seed.sql

Integrating with Claude Code

See docs/integration/claude-code.md for full setup instructions.

Quick version: Add to your .mcp.json:

{
  "mcpServers": {
    "mimir": {
      "url": "http://localhost:8100/sse",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Then add the Mimir usage snippet to your CLAUDE.md — see integration docs for the full snippet.

MCP Tools (23)

Category	Tools
Session	start_session, end_session, save_session
Context	set_context, refresh_context
Items	add_items, update_item, complete_items, archive_items, delete_items, convert_item
Navigation	get_details, list_children, get_history, add_note
Search	search_items, list_items, get_facts
Ordering	reorder_items
Scopes	list_scopes, create_scope, add_scope_member, remove_scope_member

Development

pip install -e ".[dev]"
pre-commit install   # installs ruff check/format as a git hook
pytest tests/ -v

License

MIT