Skip to main content
Glama

novara-context MCP Server

Persistent memory, identity, and context for Claude sessions — works with Claude Code, Claude.ai, and OpenClaw.

Tools

Tool

Description

recall

Search the memory graph by query

remember

Add or update an entity in the memory graph

link

Create a relation between two entities

forget

Remove a specific observation from an entity

get_identity

Returns SOUL.md + MEMORY.md context

get_conventions

Returns conventions by domain (notion, repo, linkedin, aws, etc.)

store_decision

Store a decision with title, content, and tags

consolidate

Full graph maintenance: dedupe, prune stale observations, promote new facts from daily logs

Related MCP server: Fuzzy Memory MCP Server

Setup

npm install
npm run build

Usage in Claude Code (stdio)

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "novara-context": {
      "command": "node",
      "args": ["/path/to/novara-context/dist/index.js"]
    }
  }
}

Usage as Remote Server (HTTP + Cloudflare Tunnel)

# Set required env vars
export MCP_MODE=http
export PORT=3099
export MCP_CLIENT_ID=novara-context-client
export MCP_CLIENT_SECRET=your-secret-here

# Start server
node dist/index.js &

# Expose via Cloudflare Tunnel
cloudflared tunnel --url http://localhost:3099

The server implements full OAuth 2.1 with PKCE and Dynamic Client Registration (RFC 7591) for Claude.ai connector compatibility.

Environment Variables

Variable

Default

Description

MCP_MODE

stdio

stdio or http

PORT

3099

HTTP port

MCP_CLIENT_ID

novara-context-client

OAuth client ID

MCP_CLIENT_SECRET

—

OAuth client secret (required for HTTP mode)

MEMORY_FILE_PATH

~/clawd/data/memory-graph/memory.jsonl

Memory graph data file

Memory Graph Format

The graph is stored as JSONL — one JSON object per line:

{"type":"entity","name":"Stephen Ellington","entityType":"Person","observations":["Founder of Novara"]}
{"type":"relation","from":"Stephen Ellington","to":"Novara","relationType":"FOUNDED"}

Available Tools

8 tools
consolidateB

Full memory graph maintenance: finds duplicate entities, promotes facts from daily memory files, prunes stale observations, and writes a maintenance report.

Inputs: dryRun.

forgetB

Remove a specific observation from an entity in the memory graph.

Inputs: entityName (required), observation (required).

get_conventionsB

Returns all Convention entities from the memory graph, optionally filtered by domain keyword.

Inputs: domain.

get_identityA

Returns the agent's identity (SOUL.md) and the first 3000 characters of MEMORY.md. Use at the start of a session to establish context.

Inputs: no named parameters.

recallA

Search the memory graph for entities matching a query. Returns matching entities with their observations and relations.

Inputs: query (required), limit.

rememberA

Upsert an entity in the memory graph. If the entity already exists and upsert is true (default), observations are merged. If upsert is false, the entity is overwritten.

Inputs: name (required), entityType (required), observations (required), upsert.

store_decisionC

Store an important decision in the memory graph as a Decision entity with a dated observation.

Inputs: tags (required), title (required), content (required), importance.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: recall searches, remember upserts, link adds relations, forget removes observations, get_identity retrieves context, get_conventions fetches convention entities, store_decision stores decisions, and consolidate performs maintenance. No overlap.

    Naming Consistency3/5

    Tool names mix single verbs (recall, remember, link, forget, consolidate) with verb_noun patterns (get_identity, get_conventions, store_decision). While readable, the lack of a uniform convention reduces predictability.

    Tool Count5/5

    With 8 tools, the set covers core memory graph operations without being bloated. The count feels well-scoped for the server's purpose of managing an agent's memory.

    Completeness3/5

    The tool set covers basic CRUD (create/read/update via remember, recall, link) and maintenance (consolidate), but lacks a dedicated tool to delete entire entities or list all entities. Minor gaps like these could hinder agent workflows.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables Claude to maintain persistent memory across conversations using a local knowledge graph with fuzzy search capabilities, allowing it to remember and recall information about users, relationships, and context.
      9
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides persistent memory for Claude by implementing a local knowledge graph to store and retrieve entities, relations, and observations. This enables long-term information retention and personalization across different chat sessions.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Provides persistent memory for Claude with hierarchical categorization, cross-corpus recall, session journals, and customizable persona, enabling memory continuity across sessions.
      7
      MIT