@naumu/mcp

@naumu/mcp

MCP server for Naumu — access your knowledge graph from Claude Code, Cursor, and other AI coding agents.

Setup

1. Get an API key

Generate an API key from your Naumu account settings.

2. Configure your IDE

Claude Code

claude mcp add naumu -s user \
  -e NAUMU_API_KEY=nmu_your_key_here \
  -- npx -y -p @naumu/mcp naumu-mcp

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "naumu": {
      "command": "npx",
      "args": ["-y", "-p", "@naumu/mcp", "naumu-mcp"],
      "env": {
        "NAUMU_API_KEY": "nmu_your_key_here"
      }
    }
  }
}

Available tools

Tool	Description
naumu_list_graphs	List all knowledge graphs you have access to
naumu_get_schema	Get the schema (node types, relationships) for a graph
naumu_text_search	Search nodes by exact text match on labels and content
naumu_semantic_search	Search nodes by meaning using AI embeddings
naumu_filter	Filter nodes by type and attributes with deterministic results
naumu_get_node	Get a node with all its properties and connections
naumu_add_node	Create a new node
naumu_update_node	Update an existing node
naumu_add_edge	Create a relationship between two nodes
naumu_remove_node	Delete a node and its connections
naumu_remove_edge	Delete a relationship
naumu_create_topic	Create a topic (filing destination) in a space; admin-only, name must be a lowercase slug, returns an id for topicIds params
naumu_ask	Ask @Naumu a question and get a synthesised answer back (answer + sources + confidence + threadId + status); leaves a visible thread in the space
naumu_delegate	Hand @Naumu a task to carry out asynchronously (add knowledge, make changes); returns a threadId immediately, then poll with naumu_read_thread
naumu_read_thread	Read a thread's messages; each message carries a status of processing or complete
naumu_whoami	(Bot keys) Self-introspection — id, graphId, name, instructions, allowed tools
naumu_list_threads	(Bot keys) List threads in your graph with isParticipant flag
naumu_get_thread	(Bot keys) Fetch a thread plus its human + bot participant rosters
naumu_create_thread	(Bot keys only) Start a new conversation, attach participants, post initial message, optionally file into topics via topicIds
naumu_request_attachment_upload	(Bot keys) Get a presigned S3 URL to upload a file; pair with naumu_post_message's attachmentIds
naumu_add_reaction	(Bot keys) Add an emoji reaction to a message in a thread you participate in (idempotent)
naumu_remove_reaction	(Bot keys) Remove your own reaction from a message

Environment variables

Variable	Required	Default	Description
NAUMU_API_KEY	Yes	—	Your API key (starts with nmu_)
NAUMU_API_URL	No	https://naumu.ai	Naumu API base URL (only change for self-hosted)

License

MIT