Skip to content
MCP server

Naumu

MCP server for searching and extending a team's Naumu knowledge graph from coding agents

Install
Pricing
Freemium
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
0.19.1
Listing updated
2 days ago

About Naumu

Naumu is a freemium MCP server for knowledge and memory. It can run locally on your machine or as a hosted remote server.

Naumu is a team chat that builds a shared memory graph from conversations, files and connected trackers, and this server exposes that graph to agents such as Claude Code and Cursor. The recommended path is the remote endpoint at naumu.ai/api/mcp with a browser OAuth sign-in; the npm package @naumu/mcp is a local stdio fallback for CI, bot identities and stdio-only clients, authenticated with an nmu_ API key created under Settings > Your agents.

Keys can be per-tool, and access for a connected tool can be revoked in the same settings page. Some tools are registered only for bot identity keys, which receive a subset based on the identity's permissions. The README lists tools for spaces, such as listing and creating graphs.

The pricing page says every plan includes MCP and API access, with the Free plan allowing 1,500 nodes and 20 people per space and charging by scale rather than features.

Install

Run in a terminal

claude mcp add --transport http mcp https://naumu.ai/api/mcp

Add to Settings → Connectors → Add custom connector

https://naumu.ai/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://naumu.ai/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://naumu.ai/api/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://naumu.ai/api/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://naumu.ai/api/mcp"
    }
  }
}

Configuration

  • NAUMU_API_KEYNaumu API key (starts with nmu_), created in Naumu under Settings > Your agents.Required
  • NAUMU_API_URLOverride the Naumu API base URL. Defaults to https://naumu.ai.
  • NAUMU_IDENTITY_IDOptional bot identity id to act as when the key covers several identities.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

naumu_list_graphs
List every space the key can access, with ids, names and roles.
naumu_create_graph
Create a new, empty space owned by the authenticated user.
naumu_list_members
List a space's members.

What it does

Remote OAuth endpoint
Sign in through the browser with no API key to manage.
Local stdio fallback
npx package for CI, bots and older clients.
Space management
List and create spaces the key can access.
Per-tool keys
Separate API keys so one leak costs one key.
Bot identities
Identity keys with permission-filtered tools.
Revocable access
Remove a connected tool from Settings.

Good for

  • Search team decisions from a coding agent
  • Let an agent write findings back into the graph
  • Run a CI job against team memory
  • Connect Cursor to a shared workspace

Pricing

Freemium

Free plan includes MCP and API; paid Team, Max and Enterprise plans (prices in EUR, not listed)

Prices change. Check naumu.ai before you buy.

Naumu FAQ

How do I connect?

Register https://naumu.ai/api/mcp and sign in through the browser.

When should I use the npm package?

For CI, bots, external agent identities and stdio-only clients.

Is MCP access included in the free plan?

Yes, the pricing page lists MCP and API on every plan.

How do I revoke access?

In Naumu under Settings > Your agents.

Is Naumu free?

Naumu has a free plan, with paid plans for more usage or features.

How do I add Naumu to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://naumu.ai/api/mcp

What are the best alternatives to Naumu?

The closest alternatives to Naumu are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

Alternatives to Naumu

  1. 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
  2. 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
  3. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  5. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  6. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools