Skip to content
MCP server

Mios

Team decision memory that serves reasons and sources to coding agents before they edit

Runs locallyStatus and history
Pricing
Free
Platforms
Web, self-hosted, API
Runs
Locally
Version
0.6.0
Listing updated
3 days ago

About Mios

Mios is a free MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Instead of searching documents, Mios keeps a record of each decision with who made it, why and where it came from, and gives a short sourced brief to Claude Code, Cursor or Codex before they change code. When the agent finishes, decisions are logged back. The registry entry runs it as an npm package (@mios-ai/mcp) over stdio and needs a personal access token from the Mios profile page.

The site lists 35 connectors, 14 of them live, including GitHub, GitLab, Slack, Notion, Google Drive, Jira, Confluence and Linear, with changes arriving within seconds. Each project reads only its own sources. Mios also says it finds secrets pasted into chat, code or docs and masks them.

It can run on dedicated GPUs in Zurich, on your own servers with one install script, air-gapped, or with local models through Ollama. It is in private beta and opens to a few teams at a time.

Install

Run in a terminal

claude mcp add mios --env MIOS_TOKEN='<MIOS_TOKEN>' -- npx -y @mios-ai/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mios": {
      "command": "npx",
      "args": [
        "-y",
        "@mios-ai/mcp"
      ],
      "env": {
        "MIOS_TOKEN": "<MIOS_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mios": {
      "command": "npx",
      "args": [
        "-y",
        "@mios-ai/mcp"
      ],
      "env": {
        "MIOS_TOKEN": "<MIOS_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mios": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mios-ai/mcp"
      ],
      "env": {
        "MIOS_TOKEN": "<MIOS_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mios": {
      "command": "npx",
      "args": [
        "-y",
        "@mios-ai/mcp"
      ],
      "env": {
        "MIOS_TOKEN": "<MIOS_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mios": {
      "command": "npx",
      "args": [
        "-y",
        "@mios-ai/mcp"
      ],
      "env": {
        "MIOS_TOKEN": "<MIOS_TOKEN>"
      }
    }
  }
}

Configuration

  • MIOS_TOKENPersonal access token (mios_pat_...), created on your profile page at https://app.mios-ai.comRequired
  • MIOS_URLBase URL of the Mios API. Change it only for a self-hosted Mios.

What it does

Decisions with sources
Stores each team decision with its reason and the document it came from.
Pre-edit briefs
Gives coding agents a short sourced brief before they edit and logs decisions afterwards.
Live connectors
Pulls from tools such as GitHub, Slack, Notion, Jira and Confluence, with more listed as coming.
Secret masking
Catches keys and passwords pasted into chat, code or docs and masks them.
Self-hosted option
Installs on your own servers, air-gapped, with local models through Ollama.
Onboarding tours
Builds a guided tour of a project from the mission you write.

Good for

  • Give a coding agent the reasons behind past architecture choices
  • Onboard a new teammate with a guided project tour
  • Find who can answer a question about a past decision
  • Keep several projects' knowledge separate in one workspace

Pricing

Free

Free during the private beta, limited seats; later pricing not published

Prices change. Check mios-ai.com before you buy.

Mios FAQ

Is Mios available to everyone?

Not yet. It is in private beta and opens to a few teams first; the beta is free with limited seats.

Where does the data live?

You choose: Mios's own models hosted in Switzerland, a dedicated server in Zurich, or your own servers, where everything including models runs locally.

What do I need to run the MCP package?

A personal access token (MIOS_TOKEN) created on your Mios profile page. MIOS_URL only needs changing for a self-hosted Mios.

Which agents does it work with?

The site names Claude Code, Cursor and Codex.

Is Mios free?

Yes. Mios is free to use.

How do I add Mios to Claude Code?

Run this command in your terminal: claude mcp add mios --env MIOS_TOKEN='<MIOS_TOKEN>' -- npx -y @mios-ai/mcp

What are the best alternatives to Mios?

The closest alternatives to Mios are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Mios

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools