MCP Integration

Connect external AI agents like Claude Code to Mioru via the Model Context Protocol.

What is MCP?

The Model Context Protocol (MCP) lets external AI tools read, write, and manage your Mioru notes without opening the Mioru UI. Claude Code, Codex, and other MCP-compatible agents can work directly with your vault.

Available Tools (15)

Read & Navigation

Tool	Function
`mira_list_projects`	List all projects in your vault
`mira_list_notes`	List all notes in a project
`mira_read_note`	Read a note's full content
`mira_read_home`	Read your Home Note
`mira_read_project`	Read a project's `.project.md` knowledge file
`mira_search`	Search across your vault

Write & Modify

Tool	Function
`mira_write_note`	Create or overwrite a note
`mira_write_home`	Update your Home Note
`mira_append_note`	Append text to an existing note
`mira_update_project`	Update a `.project.md` file

Manage

Tool	Function
`mira_create_project`	Create a new project/folder (with `.project.md` initialization)
`mira_move_note`	Move or rename a note (across projects)
`mira_delete_note`	Delete a note permanently

Security

All MCP tools respect the safePath guard — no access outside your configured Notes Directory is possible. The MCP server reports its version for compatibility checks.

Setup

Claude Code

claude mcp add -s user mira

Mioru uses the claude mcp add command as the primary setup path, with direct ~/.claude.json write as fallback.

Claude Desktop

Mioru automatically configures Claude Desktop's MCP settings. On Windows, it handles both MSIX (UWP) and Win32 installation paths.

Other MCP Clients

Any MCP-compatible client can connect to Mira's MCP server. Configure it as a stdio transport pointing to ~/.config/mira/mira-mcp.js.