Technical reference for Mimir’s Model Context Protocol (MCP) server — the sidecar that enables AI assistant integration.
The MCP server (mimir-mcp) runs as a Tauri sidecar process. It connects to the same SQLite database as the main app and exposes 71 tools across 10 categories.
Binary : mimir-mcp (built to crates/mimir/binaries/mimir-mcp-{target-triple})Protocol : MCP over stdioDatabase : Shared SQLite database at ~/Library/Application Support/com.mimir.app/data/mimir.dbPlugin : Claude Code plugin at crates/mimir-mcp/plugin/
The database path is auto-detected. Override with:
export MIMIR_DATABASE_PATH=/path/to/mimir.db
Tool Description
list_campaignsList all available campaigns set_active_campaignSet the active campaign (required by most tools) get_campaign_detailsGet campaign info including modules and characters get_campaign_sourcesGet enabled source books for a campaign create_campaignCreate a new campaign update_campaignUpdate campaign name or description delete_campaignDelete a campaign and all its data export_campaignExport campaign as shareable archive import_campaignImport campaign from archive preview_archivePreview archive contents without importing
Tool Description
create_moduleCreate new module in active campaign list_modulesList all modules in active campaign get_module_detailsGet module info including documents, monsters, items update_moduleUpdate module name or description delete_moduleDelete module and all contents add_monster_to_moduleAdd monster from catalog or homebrew to module remove_monster_from_moduleRemove monster from module add_item_to_moduleAdd catalog item as loot to module
Tool Description
list_documentsList campaign-level or module-level documents read_documentRead full content of a document create_documentCreate document (backstory, read_aloud, dm_notes, description, custom) edit_documentEdit document using search and replace delete_documentDelete a document reorder_documentReorder documents by swapping sort positions
Tool Description
list_charactersList characters with optional filters (type, module, location, faction) get_characterGet detailed character info including classes and inventory create_characterCreate NPC or PC (auto-populates proficiencies from catalog) edit_characterUpdate ability scores, currency, race, background, traits delete_characterDelete character and all associated data level_up_characterLevel up character (handles HP, multiclass, ASI/feats, spells) add_item_to_characterAdd catalog item to character inventory remove_item_from_characterRemove item from character inventory update_character_inventoryUpdate item quantity, equipped, or attuned state get_character_inventoryGet inventory (filterable by equipped/attuned) add_character_spellAdd spell to character’s known spells remove_character_spellRemove spell from character list_character_spellsList character’s known spells (filterable by class/prepared)
Tool Description
create_mapUpload UVTT file to create new map list_mapsList maps (optionally filtered by module) get_mapGet map details including token placements update_mapUpdate map metadata (name, description, lighting) delete_mapDelete map and associated UVTT asset add_token_to_mapAdd monster or NPC token to map list_tokens_on_mapList all tokens (optionally visible only) remove_tokenRemove token placement from map
Tool Description
generate_mapGenerate Dungeondraft map from YAML config or biome preset list_map_presetsList available biome presets validate_map_configValidate YAML config without generating
Tool Description
search_monstersSearch monster catalog (includes homebrew from active campaign) search_itemsSearch item catalog search_spellsSearch spell catalog search_racesSearch race catalog search_classesSearch class catalog search_backgroundsSearch background catalog search_featsSearch feat catalog search_conditionsSearch condition catalog
Tool Description
list_homebrew_itemsList all homebrew items in active campaign get_homebrew_itemGet homebrew item by ID create_homebrew_itemCreate new or clone from catalog update_homebrew_itemUpdate homebrew item delete_homebrew_itemDelete homebrew item
Tool Description
list_homebrew_monstersList all homebrew monsters in active campaign get_homebrew_monsterGet homebrew monster by ID create_homebrew_monsterCreate new or clone from catalog update_homebrew_monsterUpdate homebrew monster delete_homebrew_monsterDelete homebrew monster
Tool Description
list_homebrew_spellsList all homebrew spells in active campaign get_homebrew_spellGet homebrew spell by ID create_homebrew_spellCreate new or clone from catalog update_homebrew_spellUpdate homebrew spell delete_homebrew_spellDelete homebrew spell
claude plugin add /path/to/mimir/crates/mimir-mcp/plugin
Command Description
/mimir-campaignsList all available campaigns /create-moduleCreate a new module in the active campaign /search-monstersSearch the D&D monster catalog /search-spellsSearch the D&D spell catalog /generate-mapGenerate a procedural Dungeondraft map
Skill Description
/mimir-dmGeneral campaign management /encounter-balanceAnalyze encounter difficulty /loot-auditAudit treasure distribution /session-prepPre-session readiness review /continuity-checkFind contradictions across documents /npc-networkMap NPC relationships /pressure-testStress-test scenarios /mapgenCreative direction for map generation