Skip to main content

MCP server for Novyx memory — context spaces, replay, cortex, and 23 tools for Claude Desktop, Cursor, and Claude Code

Project description

novyx-mcp

MCP (Model Context Protocol) server for Novyx memory. 23 tools for Claude Desktop, Cursor, and Claude Code — including context spaces for multi-agent collaboration, replay for time-travel debugging, and cortex for autonomous memory intelligence.

Install

pip install novyx-mcp

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "novyx-memory": {
      "command": "python",
      "args": ["-m", "novyx_mcp"],
      "env": {
        "NOVYX_API_KEY": "nram_your_key_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "novyx-memory": {
      "command": "python",
      "args": ["-m", "novyx_mcp"],
      "env": {
        "NOVYX_API_KEY": "nram_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add novyx-memory -- python -m novyx_mcp

Set the NOVYX_API_KEY environment variable before starting Claude Code.

Available Tools

Core Memory (10 tools)

Tool Description
remember Store a memory observation with optional tags, importance, context, and TTL
recall Search memories semantically using natural language
forget Delete a memory by UUID
list_memories List stored memories with optional tag filtering
memory_stats Get memory statistics (total count, average importance, etc.)
rollback Rollback memory to a point in time (supports dry run)
audit Get the audit trail of memory operations
link_memories Create a directed link between two memories
add_triple Add a knowledge graph triple (subject -> predicate -> object)
query_triples Query knowledge graph triples with filters

Context Spaces (6 tools)

Multi-agent collaboration — shared memory with fine-grained permissions.

Tool Description
create_space Create a shared context space for multi-agent collaboration
list_spaces List all context spaces you own or have access to
space_memories Search or list memories within a specific context space
update_space Update space settings (description, allowed agents, tags)
delete_space Delete a context space and disassociate its memories
share_space Share a context space with another user by email

Replay (4 tools — Pro+)

Time-travel debugging — inspect how memory changed over time.

Tool Description
replay_timeline Get a chronological timeline of memory operations
replay_snapshot Reconstruct memory state at a specific point in time
replay_lifecycle Trace the full lifecycle of a single memory
replay_diff Compare memory state between two points in time

Cortex (3 tools — Pro+)

Autonomous memory intelligence — consolidation, reinforcement, and insights.

Tool Description
cortex_status Check cortex configuration and last run stats
cortex_run Trigger a cortex cycle (consolidation + reinforcement)
cortex_insights Get AI-generated insights from memory patterns (Enterprise)

Available Resources

URI Description
novyx://memories List all stored memories
novyx://memories/{memory_id} Get a specific memory by UUID
novyx://stats Memory statistics
novyx://usage Usage and plan information
novyx://spaces List all context spaces
novyx://spaces/{space_id} Get a specific context space

Available Prompts

Prompt Description
memory-context Recall relevant memories and format them as context (takes a query argument)
session-summary List all memories for a session (takes a session_id argument)
space-context Recall memories from a specific context space (takes space_id and query arguments)

Get an API Key

Sign up at novyxlabs.com to get your API key. The free tier includes 5,000 memories and 5,000 API calls per month.

License

MIT - Copyright 2026 Novyx Labs

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

novyx_mcp-2.1.2.tar.gz (26.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

novyx_mcp-2.1.2-py3-none-any.whl (20.9 kB view details)

Uploaded Python 3

File details

Details for the file novyx_mcp-2.1.2.tar.gz.

File metadata

  • Download URL: novyx_mcp-2.1.2.tar.gz
  • Upload date:
  • Size: 26.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.14

File hashes

Hashes for novyx_mcp-2.1.2.tar.gz
Algorithm Hash digest
SHA256 c8b30319edc12ecf352ebc603ba83a39915e4c2ead9c5f755aad8a3d8ca63cc1
MD5 c2270ef6743763c04a3763245c377d61
BLAKE2b-256 8e1f71c449527f9f2b4b88b8a3dadcd7271ed9938fbfa234281c8442184a0783

See more details on using hashes here.

File details

Details for the file novyx_mcp-2.1.2-py3-none-any.whl.

File metadata

  • Download URL: novyx_mcp-2.1.2-py3-none-any.whl
  • Upload date:
  • Size: 20.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.14

File hashes

Hashes for novyx_mcp-2.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 f9093247f3c0406f8b62acca74b25f2c5018e942164c8811d55e800388dd89bc
MD5 efe73f9875734228b4d42986e88f4381
BLAKE2b-256 f1b5d96dba117fea92a689f9107e6c9707931b3f2d403520ec852acbdba5c9d0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page