streamable-httpMITupdated 3mo ago
Connect your aNotepad online notes to Claude, ChatGPT, and Cursor through the Model Context Protocol . Read, search, write, and organize your notes through natural conversation.
What can you do with aNotepad?
Note: This is the public home for the aNotepad MCP server. aNotepad is a remote, hosted MCP server — there's nothing to install or run. You connect your AI client straight to the hosted endpoint below and sign in with your aNotepad account. The server source lives in the private aNotepad codebase; this repo holds the registry manifest, docs, and branding.
Connection
| Endpoint | https://api.anotepad.com/mcp |
| Transport | Streamable HTTP |
| Auth | OAuth 2.1 (PKCE) + Dynamic Client Registration (RFC 7591) — no API key setup |
| Required plan | aNotepad Pro or Max |
Quick start
- Make sure your aNotepad account is on the Pro or Max plan.
- In your AI client's settings, add an MCP server with URL
https://api.anotepad.com/mcp. - The client opens a browser window to sign in to aNotepad and approve access.
- Ask things like "summarize my recipe collection" or "find the note where I saved that GitHub link."
Client setup
- Settings → Connectors (or Settings → Developer → Edit Config on older versions).
- Add custom connector, paste
https://api.anotepad.com/mcp. - Sign in to aNotepad in the browser window and approve.
- The aNotepad tools appear under the connectors list.
- Your name (bottom left) → Settings → Connectors → Connect more.
- Add custom connector, paste
https://api.anotepad.com/mcp. - Approve the OAuth flow.
- Settings → MCP → Add new MCP server.
- Transport HTTP / SSE, URL
https://api.anotepad.com/mcp. - Save, then sign in and approve in the browser window.
npx @modelcontextprotocol/inspector
Set transport to Streamable HTTP, URL https://api.anotepad.com/mcp, then Connect.
Tools
22 tools across six groups.
| Group | Tools |
|---|---|
| Notes | list_notes, get_note, search_notes, create_note, update_note, delete_note |
| Versions | list_note_versions, get_note_version, restore_note_version |
| Export & email | get_note_download_url, email_note |
| Collections | list_collections, create_collection, move_note_to_collection, delete_collection |
| Comments | list_comments, list_recent_comments, create_comment, delete_comment |
| Files & bookmarks | list_note_files, get_note_file_download_url, delete_note_file, list_bookmarks_in_note, add_bookmark, remove_bookmark |
What's not exposed
Some operations stay on the web app, by design:
- Setting note passwords — removing a password is fine; setting a new value via AI is blocked (it would land in chat transcripts).
- File uploads — AI can list, download, and delete attachments, but new uploads go through the web app.
- Account / billing changes — plan changes, payment methods, etc. are web-app only.
- Creator wallet setup — switching a note to
Paidis supported, but the one-time wallet/email verification must be done in the web app first.
Privacy & security
- The AI sees only your own notes and their comments — never other users' notes or your account/billing data.
- Comments on public notes are wrapped in
<untrusted-comment>markers in tool responses, signaling to the AI that the text is data, not instructions — a defense against prompt injection. - Destructive tools (delete, change access, send email) are marked destructive, so most clients require an extra approval prompt.
- Note content and passwords are never written to server logs.
Rate limits
| Plan | Tool calls / min | New notes / day | Emails / hour |
|---|---|---|---|
| Pro | 60 | 1,000 | 10 |
| Max | 300 | 5,000 | 10 |
Limits are per user, shared across all connected clients.
Links
- 📖 Full documentation — https://anotepad.com/mcp-access
- 🔌 REST API — https://anotepad.com/api-access
- ✉️ Support — support@anotepad.com
License
Documentation and manifest in this repository are released under the MIT License. The hosted aNotepad service and its source code are proprietary.
Install
Add aNotepad to your client. Pick the one you use.
claude mcp add --transport http anotepad https://api.anotepad.com/mcpcodex mcp add anotepad --url https://api.anotepad.com/mcp{
"mcpServers": {
"anotepad": {
"url": "https://api.anotepad.com/mcp"
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"servers": {
"anotepad": {
"type": "http",
"url": "https://api.anotepad.com/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
{
"mcpServers": {
"anotepad": {
"url": "https://api.anotepad.com/mcp"
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"anotepad": {
"serverUrl": "https://api.anotepad.com/mcp"
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
Score
39 / 100
Incomplete
- Documentation25/25
- Maintenance16/25
- Trust13/20
- Capability0/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 85 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 6 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 1.0.0Latest | Jun 7, 2026 |