# Nauro

> Nauro is an open-source MCP server for knowledge and memory. Record approved project decisions and their reasons so coding agents recall them later. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, self-hosted
- **Website:** https://nauro.ai
- **Repository:** https://github.com/nauro-ai/nauro
- **MCP Registry name:** ai.nauro/nauro
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-15

## About

Nauro keeps a project's direction in human hands as agents do more of the work. It stores the decisions you approve, including their reasons and the alternatives you rejected, as plain Markdown on your machine, and brings those reasons back into later sessions in Claude Code, Codex or Cursor. Retrieval is advisory, and new or revised decisions need your explicit approval.

The README is candid about fit: if a small repo with a reliable AGENTS.md or CLAUDE.md keeps agents oriented, Nauro may be more than you need. It suits longer-lived work across sessions, tools and handoffs. A bundled demo, a fictional budgeting app, shows how nauro check-decision surfaces a prior decision that bears on a new request. An investigator subagent can study Claude and Codex logs for findings about how Nauro is being used.

Install with uv tool install nauro or pipx, or use the free macOS desktop app for Apple silicon. Local use needs no account. Optional cloud sync and a remote MCP include 5,000 calls a month, and it uploads the project record but not source files. Nauro says it sends no product analytics. The same website also promotes a separate hosted testing product, Nauro Agents, which is a free pilot in development.

## Features

- **Decision records:** Save approved decisions with reasons and rejected alternatives as Markdown.
- **Advisory recall:** Surface relevant past reasoning in later agent sessions without changing decisions.
- **Approval required:** New or revised decisions need your explicit approval.
- **Repo adoption:** nauro adopt wires the repository and installs skills and subagents.
- **Desktop app:** A free macOS app installs the CLI, connects agents and shows the record read-only.
- **Optional cloud sync:** Sync a project record across machines, off until you enable it.

## Good for

- Keep architectural decisions available across agent sessions
- Check a new request against earlier decisions before coding
- Hand a project to another agent without losing the reasons
- Review why an alternative was rejected months ago
- Share one project record across machines through cloud sync

## Install

### Claude Code (Terminal)

```sh
claude mcp add nauro -- uvx nauro
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "nauro": {
      "command": "uvx",
      "args": [
        "nauro"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "nauro": {
      "command": "uvx",
      "args": [
        "nauro"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "nauro": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "nauro"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "nauro": {
      "command": "uvx",
      "args": [
        "nauro"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "nauro": {
      "command": "uvx",
      "args": [
        "nauro"
      ]
    }
  }
}
```

## FAQ

### Is it free?

Yes. The pricing page says the decision system is free and open source under Apache 2.0, with no paid plan.

### Do I need an account?

Not for local use. The record is plain Markdown on your machine and cloud sync is optional.

### What gets uploaded with cloud sync?

The project record, including decisions, state and open questions. Source files are not uploaded, but anything you paste into the record is.

### What happens at the hosted limit?

Hosted calls pause until the first of the next month UTC, while the local store and MCP server keep working.

### Can a team share a hosted project?

Not yet. A hosted project has one owner and no shared membership.

### Is Nauro free?

Yes. Nauro is open source, so you can use and self-host it for free.

### How do I add Nauro to Claude Code?

Run this command in your terminal: claude mcp add nauro -- uvx nauro

### What are the best alternatives to Nauro?

The closest alternatives to Nauro 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/nauro
