xNotepad AI MCP server
Commit Aug 23, 2026Provides AI agents with persistent, encrypted memory through note creation, semantic search, and AI-powered Q&A.
Also known as rajnaik/xNotePadAI, notes
- Stars
- 0
- Tools
- 13
- Downloads, 30 days
- —
- Latest version
- 3.0.0
- Last commit
- Aug 23, 2026
- License
- MIT
What is xNotepad AI MCP?
xNotepad AI provides AI agents with persistent, encrypted memory through note creation, semantic search, and AI-powered Q&A. It exposes 13 tools, such as create_note, list_notes, get_note.
Summary generated from the project's README
About xNotepad AI MCP server
xNotepad AI provides AI agents with a persistent and encrypted memory system through a remote MCP server. Developers connect to the service using a Bearer token via a streamable HTTP endpoint. The system uses AES-256-GCM zero-knowledge encryption to ensure privacy, while tenant isolation prevents data mixing. The free tier allows for 1,000 calls per month with a rate limit of 30 requests per minute per IP.
This server includes 13 specific tools to manage information. Agents can use create_note to save data, search_notes for semantic retrieval via vector embeddings, and ask_notes to receive answers based on existing content. To maintain organization, the tools support tagging, wiki-links through link_notes, and merging content with merge_notes. A security sandbox ensures that agents can only modify or delete notes specifically tagged as agent-created.
What you can do with it
- 1Persistent Agent MemoryAn AI agent can save research findings and architectural decisions to access them in future sessions.
- 2Semantic Knowledge RetrievalA developer can ask an AI to find specific information buried within previously saved notes.
- 3Automated Note ManagementThe system can automatically organize information by tagging, linking, or merging duplicate notes.
- 4Collaborative Multi-Agent WorkflowsOne AI agent can write information that a different agent reads at a later time.
Written from the project's README. Every use case is checked against a quote from it.
How to install xNotepad AI MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall xNotepad AI MCP in Claude Code
$ claude mcp add --transport http notes https://www.xnotepadai.com/api/mcp/Install xNotepad AI MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"notes": {
"url": "https://www.xnotepadai.com/api/mcp/"
}
}
}Install xNotepad AI MCP in VS Code
.vscode/mcp.json
{
"servers": {
"notes": {
"type": "http",
"url": "https://www.xnotepadai.com/api/mcp/"
}
}
}Install xNotepad AI MCP in VS Code CLI
$ code --add-mcp '{"name":"notes","type":"http","url":"https://www.xnotepadai.com/api/mcp/"}'Install xNotepad AI MCP in Codex
$ codex mcp add notes --url https://www.xnotepadai.com/api/mcp/Install xNotepad AI MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.notes] url = "https://www.xnotepadai.com/api/mcp/"
Install xNotepad AI MCP in Gemini CLI
$ gemini mcp add -s user --transport http notes https://www.xnotepadai.com/api/mcp/Install xNotepad AI MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"notes": {
"url": "https://www.xnotepadai.com/api/mcp/",
"type": "http"
}
}
}xNotepad AI MCP tools 13
Detected from the READMEcreate_notelist_notesget_noteupdate_notedelete_notesearch_notesask_notesget_versionstag_notelink_notesmerge_notesarchive_note
Show all 13 toolsShow fewer tools
index_notes
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablerajnaik/xnotepadai is public and reachablegithub.com/rajnaik/xnotepadai ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-23github.com/rajnaik/xnotepadai ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeEndpoint did not answer initialize: HTTP 200Finding
README
View on GitHubxNotePadAI — MCP Server
A 13-tool MCP server that gives AI agents persistent, encrypted, searchable memory via notes.
Endpoint: https://www.xnotepadai.com/api/mcp/
Protocol: MCP (Model Context Protocol) JSON-RPC over Streamable HTTP
Auth: Bearer token
Free tier: 1,000 calls/month
Quick Start
{
"mcpServers": {
"xnotepad": {
"type": "http",
"url": "https://www.xnotepadai.com/api/mcp/",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
Get your token: https://www.xnotepadai.com/settings/ → Your MCP Token (pre-generated, ready to copy)
Tools
| Tool | Description |
|---|---|
create_note |
Create a note (auto-tagged agent-created) |
list_notes |
List all notes with titles, sizes, dates |
get_note |
Get full note content by ID |
update_note |
Update content (agent-created notes only) |
delete_note |
Delete a note (agent-created only) |
search_notes |
Semantic search via vector embeddings |
ask_notes |
Ask a question — AI answers from note content |
get_versions |
Get version history for a note |
tag_note |
Add tags to a note |
link_notes |
Add [[wiki-links]] between notes |
merge_notes |
Merge two notes (source deleted after) |
archive_note |
Archive a note |
index_notes |
Vectorise notes for semantic search |
Security Model
- Bearer token auth — SHA-256 hashed, stored in D1, revocable
- Tenant isolation — tenant ID derived from token lookup, never from client args
- Agent sandboxing — agents can only modify/delete notes tagged
agent-created - Rate limiting — 30 req/min per IP
- Zero-knowledge encryption — notes encrypted client-side with AES-256-GCM (MCP accesses unencrypted copies synced by the user)
Use Cases
- AI memory — agents save research, decisions, architecture notes between sessions
- Knowledge retrieval — "What did I decide about auth?" → searches your notes
- Note automation — auto-tag, auto-link, merge duplicates, archive old notes
- Multi-agent workflows — one agent writes, another reads later
Stack
- Cloudflare Workers (runtime)
- Cloudflare D1 (database)
- Cloudflare Vectorize (semantic search)
- Workers AI / Llama 3.3 70B (AI answers)
Docs
- MCP Integration: https://www.xnotepadai.com/mcp/
- API Reference: https://www.xnotepadai.com/developers/
- Privacy: https://www.xnotepadai.com/privacy/
License
MIT
xNotepad AI MCP questions
How do I add xNotepad AI MCP to Claude Code?
Run claude mcp add --transport http notes https://www.xnotepadai.com/api/mcp/ in your terminal. Add --scope user to make it available in every project.
How do I add xNotepad AI 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 xNotepad AI MCP provide?
It exposes 13 tools, including create_note, list_notes, get_note, update_note, delete_note.
How much does it cost to use?
There is a free tier available that includes 1,000 calls per month.
How is my data secured?
The server uses zero-knowledge encryption where notes are encrypted client-side with AES-256-GCM.
Can an AI agent delete any note?
No, agents are sandboxed and can only modify or delete notes that are tagged as agent-created.
What kind of search is supported?
The server supports semantic search using vector embeddings.