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.1.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.1-py3-none-any.whl (20.8 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for novyx_mcp-2.1.1.tar.gz
Algorithm Hash digest
SHA256 b6dc4f4ff65b938575ea1f2becc7f574cc48b0e37af0d69d33f159c4ec065a73
MD5 ad7ae9748e7d89c7dec3f62d7191e4ba
BLAKE2b-256 f172ad97667a46be97b04c9844a6a41670faafe2578f1f8c0b7ca5a7813d7ebd

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for novyx_mcp-2.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 67b13995fb308c13da992f20868baa754a7fefe0daeb4f516fc776c02ef92693
MD5 11bb69a07502eec3e139920788f7172d
BLAKE2b-256 d0d5895f8be5a8853e154f9e3da9c9f60e0ff065206ff60d1235e525d711459d

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