Mios
Team decision memory that serves reasons and sources to coding agents before they edit
- 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/mcpAdd 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.comRequiredMIOS_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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools