Skip to content
Mimir

AI Assistant Integration

Use Mimir with Claude Code for AI-assisted campaign management via natural language.

What It Does

Section titled “What It Does”

Mimir includes an MCP (Model Context Protocol) server that exposes 54 tools to Claude Code, enabling you to manage campaigns, search catalogs, generate maps, and prep sessions through conversation. Ask “create a forest map” or “find CR 5 undead monsters” and the assistant handles it.

Prerequisites

Section titled “Prerequisites”
  • Mimir desktop app installed
  • Claude Code installed
  • The mimir-mcp binary (installed alongside the app, or built from source)

Setup

Section titled “Setup”

For App Users

Section titled “For App Users”

Inside the desktop app, the MCP server runs as a sidecar — a companion process bundled with the app that launches automatically. For Claude Code, you use the standalone mimir-mcp binary instead. On macOS, the install script places it at ~/.local/bin/mimir-mcp, so it’s already on your PATH (if not, add ~/.local/bin to your PATH). On Linux and Windows, download the binary for your platform from GitHub Releases (e.g. mimir-mcp-x86_64-unknown-linux-gnu or mimir-mcp-x86_64-pc-windows-msvc.exe), or build it from source as described below.

  1. Register the server with Claude Code:

    Terminal window
    claude mcp add mimir -- mimir-mcp

  2. Install the Claude Code plugin. Inside a Claude Code session, add the Mimir marketplace, then install the plugin:

    /plugin marketplace add mimir-dm/mimir
    /plugin install mimir-dm@mimir

From Source

Section titled “From Source”

If you’re working from the Mimir repository, build the binary yourself:

Terminal window
cargo build --release -p mimir-mcp

Then register the built binary (target/release/mimir-mcp) with claude mcp add as above.

Database Path

Section titled “Database Path”

The server auto-detects the Mimir database on macOS (~/Library/Application Support/com.mimir.app/data/mimir.db) and Linux ($XDG_DATA_HOME/com.mimir.app/data/mimir.db, falling back to ~/.local/share/...). On Windows there is no default — you must set the environment variable:

Terminal window
# macOS / Linux
export MIMIR_DATABASE_PATH=/path/to/mimir.db
Terminal window
# Windows (PowerShell)
$env:MIMIR_DATABASE_PATH = "C:\Users\you\AppData\Roaming\com.mimir.app\data\mimir.db"

You can find your database path in the app under Settings > Integrations, which displays it with a copy button.

See Environment Variables for details.

Available Tools, Commands, and Skills

Section titled “Available Tools, Commands, and Skills”

The full listing of MCP tools, plugin slash commands, and skills lives in the MCP Server Reference. In brief, tools cover campaign, module, document, character, and map management, map generation, homebrew content, and catalog search.

Example Workflows

Section titled “Example Workflows”

Campaign setup:

“Create a new campaign called ‘Curse of Strahd’ and add a module for Death House”

Monster search:

“Find all CR 3-5 undead monsters from the Monster Manual”

Map generation:

“Generate a dark swamp map with standing water and dim lighting”

Session prep:

“Run a session prep check on the Goblin Hideout module”

Character management:

“Add a +1 longsword to Aldric’s inventory”

Important Notes

Section titled “Important Notes”
  • MCP tools modify the database directly — there is no undo
  • Export your campaign regularly as a backup
  • The assistant is the DM’s tool — it prompts for choices rather than making creative decisions autonomously
  • Set the active campaign with set_active_campaign before using campaign-specific tools