Notes MCP server
online · 100% uptimedev.jpwilliams.notes/notes·v1.0.0A daily notebook your AI writes in — on today's page, in your entity graph, marked as its own.
0 stars
Reviews
Write oneNobody has reviewed Notes yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Notes tools
Tool list not cached yet. `describe` through the gateway fetches it live.
Public scan report
scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it
- –Code scanremote-only server, no package to scann/a
- Live reliabilityremote reachable in 266ms (auth required)20/20
- –Tool poisoningtools not inspected (endpoint requires auth); not countedn/a
- Auth qualityOAuth resource metadata advertised on 40115/15
- Maintenancelast push 74 days ago12/15
- Maintainer identityendpoint served from the registry-verified namespace domain8/10
How Notes compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 95% of 48,255 servers
- Uptime
- 100%
- of our recent checks; the typical remote server answers 100%
- Response time
- 425 ms
- faster than 35% of 30,031 servers
Install Notes in Claude Code, Cursor or VS Code
claude mcp add --transport http notes https://notes.jpwilliams.dev/api/v1/mcp
What the publisher says
From the Notes repository's README, as published. We do not edit it. Read it on GitHub
Notes — a notebook your AI writes in
A daily bullet notebook for Notes — as a Claude Code plugin, as a standalone Agent Skill for every other client, and as a plain MCP URL for anything that reads one.
Your AI keeps notes in your notebook, on its own initiative: on today's page, tagged into the same entity graph as everything you write, marked so you can always tell whose bullet is whose. Weeks later you open a project's page and your notes and its notes are on one page, in date order. And the next session reads it back, so you do not re-explain.
It is not a memory database. There is no vector index, no eviction policy, no hooks, no bring-your-own-Postgres. The memory is a bullet in a notebook you already read, correctable by hand, with a link back to the conversation that produced it.
Install
Claude Code
/plugin marketplace add jpwilliams/notes-skill
/plugin install notes@notes-skillCursor, VS Code, Codex, Gemini CLI, Antigravity, Amp, OpenCode, Warp…
The skill and the connection are separate here, because these clients read the open Agent Skills format and take an MCP server URL of their own.
gh skill install jpwilliams/notes-skillThat installs into .agents/skills/, the vendor-neutral path they share — so it is one command regardless of which of them you use. (npx skills add jpwilliams/notes-skill does the same thing if you would rather not use the GitHub CLI.) Then add the MCP server:
https://notes.jpwilliams.dev/api/v1/mcpAnything else
Any client that speaks remote MCP can use that URL directly, with no package and nothing installed — it discovers the rest itself. notes.jpwilliams.dev/install has the per-client instructions.
What happens next, whichever route you took
A browser opens. Sign in to the account you already have, read what the connection will be able to do, and give it a name — that name is what appears on every bullet it writes, so make it the thing you would want to read in the middle of a day's notes. "Work laptop" beats "Claude".
That is the whole setup. No key to issue, no key to paste, no keychain, no claude mcp add and no URL. You can disconnect it at any time from the 🔑 Machine access page at notes.jpwilliams.dev, and it stops working immediately.
On the desktop app and the website
The same connection, without the plugin. Add Notes as a custom connector using the URL https://notes.jpwilliams.dev/api/v1/mcp — the app discovers the rest and sends you to the same screen to approve it and name it. The plugin is worth having in the terminal because it carries a skill that teaches Claude when to reach for the notebook; the connector on its own carries the tools and a shorter version of the same guidance, sent by the server itself.
What it can do
Four tools, and a skill that teaches an agent when to reach for them.
What it deliberately cannot do
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Notes: common questions
- Is Notes MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Notes safety report
- How do I install Notes?
- It runs remotely at notes.jpwilliams.dev. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Notes need an API key?
- No key to paste: it signs you in with OAuth when your client connects.
- Is Notes maintained?
- The last commit was 75 days ago (2026-08-20). The latest release is v1.0.0.
- Is Notes up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- How does Notes compare with other MCP servers?
- safety score 92/100 (higher than 95% of 48,255 servers); uptime 100% (of our recent checks; the typical remote server answers 100%); response time 425 ms (faster than 35% of 30,031 servers). Full comparison.