# Mios

> Mios is a free MCP server for knowledge and memory. Team decision memory that serves reasons and sources to coding agents before they edit. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, self-hosted, API
- **Website:** https://mios-ai.com
- **MCP Registry name:** com.mios-ai/mios
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/mios
