Oneda MCP server
Commit Aug 30, 2026Provides Claude Code with persistent institutional memory by automatically retrieving and recording technical decisions, specs, and learnings.
Also known as nova-oneda/cli, cli
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.3
- Last commit
- Aug 30, 2026
- License
- MIT
What is Oneda MCP?
Oneda provides Claude Code with persistent institutional memory by automatically retrieving and recording technical decisions, specs, and learnings.
Summary generated from the project's README
About Oneda MCP server
Oneda provides Claude Code with a persistent layer of institutional memory to prevent the loss of technical context between sessions. It functions as an MCP server that automatically retrieves past decisions, specifications, and learnings before starting significant tasks. This ensures that previous architectural choices or rejected technologies remain known to the AI even after context resets or session restarts.
Developers can integrate this tool by installing the @nova-oneda/cli via npm and running the setup command with an API key. The system requires Node.js 18+ and an existing Claude Code installation. New users receive 50 free AI-assisted memory calls before needing to provide their own Anthropic key. The server manages credentials securely using the macOS Keychain, Linux Secret Service, or AES-256-GCM encryption on other platforms.
Once configured, the server operates in the background without manual intervention. It records new information when explicitly instructed, such as when a user tells the agent to remember a specific technology choice. This creates a governed repository of knowledge that survives team turnover and project shifts.
What you can do with it
- 1Preventing redundant technology suggestionsAsk the AI to suggest a library and have it check if that tool was previously rejected for specific reasons.
- 2Recording new technical decisionsInstruct the AI to save a specific architectural choice into its long-term memory for future sessions.
- 3Automating context retrievalLet the agent pull relevant historical data automatically before beginning a large coding task.
Written from the project's README. Every use case is checked against a quote from it.
How to install Oneda MCP
Formats verified 10 Nov 2026Install Oneda MCP in Claude Code
$ claude mcp add --transport http cli https://oneda.freeelatech.com/mcpInstall Oneda MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cli": {
"url": "https://oneda.freeelatech.com/mcp"
}
}
}Install Oneda MCP in VS Code
.vscode/mcp.json
{
"servers": {
"cli": {
"type": "http",
"url": "https://oneda.freeelatech.com/mcp"
}
}
}Install Oneda MCP in Codex
~/.codex/config.toml
[mcp_servers.cli] url = "https://oneda.freeelatech.com/mcp"
Install Oneda MCP in Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"cli": {
"httpUrl": "https://oneda.freeelatech.com/mcp"
}
}
}Configuration
NOVA_MEMORY_API_KEY
| Name | Description | |
|---|---|---|
| NOVA_MEMORY_API_KEY | — |
README
View on GitHubNova Oneda CLI
Persistent, governed institutional memory for Claude Code — connect Nova Oneda's MCP server in one command.
Claude Code forgets everything between sessions. Ask it to build a new feature six weeks after you decided "we're not using Redux, we tried it in Q2 and it caused more bugs than it fixed" and it'll cheerfully suggest Redux again. Nova Oneda gives Claude Code that memory back — it pulls relevant past decisions and context automatically before substantial work, and records new ones as you go, so institutional knowledge survives context resets, session restarts, and team turnover.
Install
npm install -g @nova-oneda/cli
Requires Node.js 18+ and Claude Code already installed.
Get an API key
Nova Oneda accounts are free to create, and new accounts get 50 free AI-assisted memory calls before you ever need to connect your own Anthropic key:
- Sign up at oneda.freeelatech.com
- Open the API Keys page and create a key (starts with
nv_live_)
Setup
nova-oneda setup --key nv_live_...
Or set it once as an environment variable and omit --key on every run:
export NOVA_MEMORY_API_KEY=nv_live_...
nova-oneda setup
This validates the key, confirms Claude Code is installed, registers Nova Oneda as an MCP server in your Claude Code config, and stores the key locally so you don't need to pass it again.
Commands
| Command | What it does |
|---|---|
nova-oneda setup --key <key> |
Configure Nova Oneda in Claude Code |
nova-oneda doctor |
Check that your key and Claude Code connection are healthy |
nova-oneda uninstall (alias remove) |
Remove Nova Oneda from Claude Code and delete the local credential |
Where your key is stored
- macOS — system Keychain, via the built-in
securitytool - Linux — Secret Service (libsecret), via
secret-tool, when available - Everywhere else — an AES-256-GCM encrypted file under
~/.nova-oneda/, mode0600
Your key is never written to a plaintext file or checked into any project directory.
Once connected
Just use Claude Code normally. Nova Oneda works automatically in the background — pulling relevant memory before substantial work, and recording decisions when you ask it to ("Remember that we chose Postgres for billing, in Nova Oneda"). See oneda.freeelatech.com after signing in for the full list of what you can ask it to do.
Uninstalling
nova-oneda uninstall
This removes Nova Oneda from Claude Code and deletes your locally stored key. Your account and everything Nova Oneda has already remembered stay available at oneda.freeelatech.com — this only removes the local connection.
License
MIT
Oneda MCP questions
How do I add Oneda MCP to Claude Code?
Run claude mcp add --transport http cli https://oneda.freeelatech.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Oneda MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Is there a free tier available?
Yes, new accounts receive 50 free AI-assisted memory calls before requiring your own Anthropic key.
What happens if I uninstall the CLI?
Uninstalling removes the local connection and credentials from Claude Code, but your account and recorded memories remain accessible online.