Provides a local searchable archive of chat sessions and project decisions for AI agents to maintain long-term memory on macOS.
Also known as clementrog/onadit
- Stars
- 0
- Tools
- 9
- Downloads, 30 days
- —
- Latest version
- 1.0.23
- Last commit
- Nov 12, 2026
- License
- —
What is Onadit MCP?
Onadit provides a local searchable archive of chat sessions and project decisions for AI agents to maintain long-term memory on macOS. It exposes 9 tools, such as onadit_context_pack, onadit_search, onadit_conversations_search.
Summary generated from the project's README
About Onadit MCP server
Onadit provides a local searchable archive for macOS users to maintain long-term memory for AI agents. It works by importing past chats and capturing sessions from tools like Claude Code, Codex, and Cursor. The system runs as a local process on your Mac, ensuring that conversations and search indexes remain on your machine rather than in a cloud account.
Developers can connect the server to various MCP clients using a terminal command or the built-in Connect button in the app. The server includes nine specific tools, such as onadit_context_pack for gathering project rules and onadit_search for finding specific information across digests and files. While keyword search is available immediately, search by meaning requires a Voyage key to function. This setup allows an agent to recall previous decisions so you do not have to repeat project context repeatedly.
This tool is designed for Apple silicon users running macOS 14 or later. It functions as a local relay to the Onadit engine, requiring Node 20.19 or later if installed via npm. The service offers a seven-day free trial before moving to a monthly subscription model.
What you can do with it
- 1Retrieve project contextAsk the agent to find earlier decisions and project rules to avoid repeating instructions.
- 2Search conversation historySearch through your archived chats and project files for specific information.
- 3Filter past discussionsLocate specific conversations based on their topic, date, or the decisions made within them.
- 4Archive new notesSave a specific session or a new note directly into your local archive.
Written from the project's README. Every use case is checked against a quote from it.
How to install Onadit MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Onadit MCP in Claude Code
$ claude mcp add onadit -- npx -y onaditInstall Onadit MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"onadit": {
"command": "npx",
"args": [
"-y",
"onadit"
]
}
}
}Install Onadit MCP in VS Code
.vscode/mcp.json
{
"servers": {
"onadit": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"onadit"
]
}
}
}Install Onadit MCP in VS Code CLI
$ code --add-mcp '{"name":"onadit","type":"stdio","command":"npx","args":["-y","onadit"]}'Install Onadit MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"onadit": {
"command": "npx",
"args": [
"-y",
"onadit"
]
}
}
}Install Onadit MCP in Codex
$ codex mcp add onadit -- npx -y onaditInstall Onadit MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.onadit] command = "npx" args = ["-y", "onadit"]
Install Onadit MCP in Gemini CLI
$ gemini mcp add -s user onadit npx -- -y onaditInstall Onadit MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"onadit": {
"command": "npx",
"args": [
"-y",
"onadit"
]
}
}
}Onadit MCP tools 9
Detected from the READMEonadit_context_packonadit_searchonadit_conversations_searchonadit_open_evidenceonadit_saveonadit_log_outcomeonadit_statusonadit_why_evidenceonadit_forget_evidence_feedback
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachableclementrog/onadit is public and reachablegithub.com/clementrog/onadit ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-12github.com/clementrog/onadit ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from onaditPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model9 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubOnadit
Onadit is a Mac app that keeps the chats you import, and your Claude Code and Codex sessions once you turn on capture, in a searchable archive on your Mac. Claude Code, Codex, Cursor and any MCP client that can start a local process search it for your earlier decisions, so you explain your project once.
Download for Mac | Docs | Privacy | onadit.com
What this repository holds
This repository holds the signed macOS installer for Onadit (in Releases) and this README. The source code is not published here.
- Mac only: Apple silicon and macOS 14 or later. It does not install on Intel Macs
- Signed with a Developer ID certificate and notarized by Apple. Each release lists the package's SHA-256
- Free for 7 days, then €5 a month until 31 December 2026 and €9 a month after, excluding VAT. The 7 days start with your first import or captured session after you turn on search by meaning in the app, on the key Onadit pays for. With your own Voyage key there is no clock. After the 7 days, without a license, your archive and keyword search keep working, and capture and search by meaning pause. See Free week and license
Install
- Download
Onadit.pkgfrom onadit.com/download or from the latest release - Open it. It installs for your user only, with no admin password
- Onadit.app opens. Import past chats and connect your agents. Capture of new sessions is off until you turn it on, and needs search by meaning plus Claude Code or Codex signed in
Full steps: Install and Quickstart.
Connect your agents
Use the Connect button for each tool in Onadit.app, or one command in Terminal:
~/.rift/bin/onadit mcp install --client claude-code # or codex, cursor, claude-desktop
~/.rift/bin/onadit mcp install --all # all 4
It points the agent at the Node and MCP server installed with the app, backs up the config file first and keeps your other servers. Restart the agent afterwards.
To add it by hand instead, install Onadit for Mac first: the MCP server only relays to the Onadit engine on your Mac. The entries below start it from npm, so they need Node 20.19 or later on your PATH.
Claude Code
claude mcp add --scope user onadit -- npx -y onadit mcp serve
Codex
codex mcp add onadit -- npx -y onadit mcp serve
Or add this to ~/.codex/config.toml:
[mcp_servers.onadit]
command = "npx"
args = ["-y", "onadit", "mcp", "serve"]
Cursor: add the onadit entry inside mcpServers in ~/.cursor/mcp.json, next to your other servers.
{
"mcpServers": {
"onadit": {
"command": "npx",
"args": ["-y", "onadit", "mcp", "serve"]
}
}
}
If Cursor reports that npx is missing, use the Connect button in Onadit.app instead: that entry uses the Node installed with the app.
There is no API key in the entry. Other MCP clients that can start a local process take the same command. See Connect an agent.
Tools
Onadit's MCP server has 9 tools.
| Tool | What it does |
|---|---|
onadit_context_pack |
Gets context before a task: earlier decisions, project rules and matching past conversations, in a few KB |
onadit_search |
Looks for something specific across your conversations, digests and project files |
onadit_conversations_search |
Filters past conversations by source, topic, decision or date |
onadit_open_evidence |
Opens the full passage behind a result, and records that it was opened |
onadit_save |
Files a session or a note in the archive |
onadit_log_outcome |
Records which passages a task actually used |
onadit_status |
Shows what Onadit holds and which tool to use for which job |
onadit_why_evidence |
Shows what Onadit recorded about one passage |
onadit_forget_evidence_feedback |
Resets what Onadit recorded about one passage, without deleting the passage |
Each tool's inputs and outputs: MCP tools.
Privacy
- Your conversations and the search index stay on your Mac. No Onadit account is needed
- A fresh install uses keyword search and makes no AI calls
- Search by meaning is off until you turn it on. Then the text Onadit indexes and the searches are sent to Voyage's models to be embedded, with a key Onadit gives you or your own. Turned on in the app, it also sends your existing archive once
- Capture is off until you turn it on. It sends sessions to Claude Code or Codex, under your own account, to judge and summarise them
- What an agent retrieves from Onadit enters that agent's chat, and goes to its provider like the rest of the chat
- The app checks
registry.npmjs.orgfor a newer version at start and about once an hour. That request carries no content and no ID - No telemetry, no analytics, no crash reports
Every network call, one by one: What leaves your Mac. In plain words: Privacy.
Support
Questions and bugs: support@onadit.com.
Onadit MCP questions
How do I add Onadit MCP to Claude Code?
Run claude mcp add onadit -- npx -y onadit in your terminal. Add --scope user to make it available in every project.
How do I add Onadit MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Onadit MCP provide?
It exposes 9 tools, including onadit_context_pack, onadit_search, onadit_conversations_search, onadit_open_evidence, onadit_save.
What hardware is required to run Onadit?
Onadit requires an Apple silicon Mac running macOS 14 or later; it does not support Intel Macs.
How much does Onadit cost?
It is free for 7 days, then costs €5 a month until December 31, 2026, and €9 a month thereafter, excluding VAT.
Is my data private?
Yes, your conversations and search index stay on your Mac, and no Onadit account is required.
Does it require an API key for the MCP server?
No, there is no API key required in the MCP server entry.