Resonant AI Framework
Open-source relational AI framework with identity persistence, memory, and MCP integration. Build relationship-aware AI agents that remember, grow, and maintain continuity. Built on Claude Agent SDK.
What is Resonant AI Framework?
Resonant AI Framework is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to open-source relational ai framework with identity persistence, memory, and mcp integration. build relationship-aware ai agents that remember, grow, and maintain continuity. built on claude agent sdk.
Open-source relational AI framework with identity persistence, memory, and MCP integration. Build relationship-aware AI agents that remember, grow, and maintain continuity. Built on Claude Agent SDK.
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Open-source relational AI framework with identity persistenc
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx resonantConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Resonant AI Framework
Resonant is an open-source relational AI framework built on the Claude Agent SDK that gives AI companions persistent identity, long-term memory, and autonomous scheduling. Unlike stateless chat sessions, Resonant maintains continuity across conversations through a personality file, memory system, and wake prompts — enabling AI agents that remember users, grow over time, and run scheduled tasks independently. It includes a web UI, voice transcription, Discord/Telegram integrations, and 13 MCP tools for life management including planning, care tracking, and calendar features.
Prerequisites
- Node.js 20–24 LTS (Node 25+ is not supported due to native addon crashes)
- Claude Code CLI installed and logged in via 'claude login', or an Anthropic API key
- Git for cloning the repository
- An MCP-compatible client; Resonant runs its own local web UI at port 3002
- Optional: Groq API key for voice transcription, ElevenLabs API key for text-to-speech
Clone the Resonant repository
Clone the source code and enter the project directory.
git clone https://github.com/codependentai/resonant.git
cd resonantInstall Node.js dependencies
Install all required npm packages.
npm installRun the interactive setup wizard
The setup wizard creates the resonant.yaml configuration file, sets up your companion's identity, and configures all required settings including timezone, model selection, and optional integrations.
node scripts/setup.mjsBuild and start the server
Build the TypeScript frontend and start the Resonant server. The web UI will be available at http://localhost:3002.
npm run build
npm startCustomize identity and personality
Edit CLAUDE.md in the project root to define your companion's personality in natural language. Edit prompts/wake.md to configure autonomous behavior that runs on schedule. Long-term memories are stored in the Claude Code memory.md system.
Set up autonomous routines (optional)
Use the sc CLI tool to create scheduled routines, enable the pulse system, and configure impulse triggers that fire when conditions are met.
# Create a daily morning routine
node tools/sc.mjs routine create "morning" "0 8 * * *" --prompt "Run the morning check-in"
# Enable autonomous pulse
node tools/sc.mjs pulse enableResonant AI Framework Examples
Client configuration
To expose Resonant's MCP tools to an external MCP client, configure it in .mcp.json pointing to the running Resonant server.
{
"mcpServers": {
"resonant": {
"command": "node",
"args": ["/absolute/path/to/resonant/dist/mcp-server.js"]
}
}
}Prompts to try
Example interactions with a Resonant AI companion via the web UI at http://localhost:3002.
- "What do you remember about my goals from our last conversation?"
- "Add a task to my planner: finish the quarterly report by Friday"
- "Create a new routine that checks in with me every Monday morning at 9am"
- "How have I been doing on my care tracker this week?"
- "Set a timer called 'standup' for 15 minutes from now and remind me to prepare notes"Troubleshooting Resonant AI Framework
Server crashes immediately on Node 25+
Resonant uses native Node.js addons that are incompatible with Node 25+. Downgrade to a Node 20–24 LTS release using nvm: 'nvm install 22 && nvm use 22', then rebuild with 'npm install && npm run build'.
Claude Code authentication fails during setup
Run 'claude login' from your terminal to authenticate. If you prefer to use an API key directly, open the Resonant web UI settings after starting the server and enter your Anthropic API key there instead.
resonant.yaml not found or setup wizard errors
Re-run 'node scripts/setup.mjs' to regenerate the config. If the wizard fails, copy examples/resonant.yaml to resonant.yaml and edit it manually with your identity and model settings.
Frequently Asked Questions about Resonant AI Framework
What is Resonant AI Framework?
Resonant AI Framework is a Model Context Protocol (MCP) server that open-source relational ai framework with identity persistence, memory, and mcp integration. build relationship-aware ai agents that remember, grow, and maintain continuity. built on claude agent sdk. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Resonant AI Framework?
Follow the installation instructions on the Resonant AI Framework GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Resonant AI Framework?
Resonant AI Framework works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Resonant AI Framework free to use?
Yes, Resonant AI Framework is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
Resonant AI Framework Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to Resonant AI Framework? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.
MemPalace
★ 52.6kA local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically
Kratos
★ 25.7k🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.
Context Mode
★ 15.4kAn MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm
Memu
★ 13.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u
Everos
★ 5.4kBuild, evaluate, and integrate long-term memory for self-evolving agents.
Browse More Knowledge & Memory MCP Servers
Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Resonant AI Framework in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Resonant AI Framework?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.