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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mimir_memory_mcp-0.15.0.tar.gz (252.6 kB view details)

Uploaded Aug 5, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

mimir_memory_mcp-0.15.0-py3-none-any.whl (63.1 kB view details)

Uploaded Aug 5, 2026 Python 3

File details

Details for the file mimir_memory_mcp-0.15.0.tar.gz.

File metadata

Download URL: mimir_memory_mcp-0.15.0.tar.gz
Upload date: Aug 5, 2026
Size: 252.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mimir_memory_mcp-0.15.0.tar.gz
Algorithm	Hash digest
SHA256	`f1e8828a4603e09641336705c920080ecdabf36e437ce96d9809600d2e209551`
MD5	`6f1a0744087f2579c4c23843378a55ab`
BLAKE2b-256	`cebf73669542a452d11cf85b7a5f7e0b8144584a5be689fc8e524012026dac14`

See more details on using hashes here.

Provenance

The following attestation bundles were made for mimir_memory_mcp-0.15.0.tar.gz:

Publisher: release.yml on jimmy-larsson/mimir

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: mimir_memory_mcp-0.15.0.tar.gz
- Subject digest: f1e8828a4603e09641336705c920080ecdabf36e437ce96d9809600d2e209551
- Sigstore transparency entry: 2343547866
- Sigstore integration time: Aug 5, 2026
Source repository:
- Permalink: jimmy-larsson/mimir@cedd457fae0c5e6d32fc3fcc8238cf1f7544fc11
- Branch / Tag: refs/tags/v0.15.0
- Owner: https://github.com/jimmy-larsson
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@cedd457fae0c5e6d32fc3fcc8238cf1f7544fc11
- Trigger Event: push