notability-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
notability-mcp
An MCP server for your Notability notes. It lets Claude, Cursor or any other MCP client search and read what you wrote, including handwriting.
Unofficial and not affiliated with Ginger Labs. Notability has no public API, so this reads your notes through the private API its web app uses, which can change without notice.
How it works
notability-mcp sync downloads your notes into a SQLite file on your computer and runs OCR on
every handwritten page. Search is fuzzy, so "conjugate" still finds a page the OCR read as
"conjogate". The text of PDFs your notes are written on, like lecture slides or past exams, is
searchable too.
OCR is rough, especially on math, so the server can also return any page as an image: your ink drawn over its PDF page. A model that reads images, like Claude, can then read your handwriting directly.
The server itself only reads that local file. It never loads your Notability token and makes no
network requests; sync is the only command that talks to Notability.
Related MCP server: obsidian-mcp
Requirements
macOS, Windows or Linux
A Notability account with your notes synced to it
Setup
1. Install
uv tool install git+https://github.com/adriandlam/notability-mcpThis puts notability-mcp on your PATH. To update it later, run uv tool upgrade notability-mcp.
2. Log in
notability-mcp loginYou'll be asked for your nb-auth-token, the cookie Notability's web app signs you in with. To
copy it, sign in at notability.com/app, open your browser's
developer tools, go to Application (Chrome, Edge) or Storage (Firefox, Safari), then Cookies >
https://notability.com, and copy the value of nb-auth-token.
The token is saved in your system keychain: Keychain on macOS, Credential Manager on Windows, Secret Service on Linux.
3. Sync
notability-mcp syncThe first sync downloads every note and its PDFs and runs OCR on each handwritten page. For 4,000 pages that takes about 10 minutes on a Mac and up to an hour on Windows or Linux, where OCR is slower. Later syncs only fetch notes that changed. Run it again whenever you want new notes to show up, or schedule it with cron, launchd or Task Scheduler.
4. Connect your client
Most clients take this config:
{
"mcpServers": {
"notability": {
"command": "notability-mcp",
"args": ["serve"]
}
}
}If your client can't find notability-mcp, use its full path, from which notability-mcp (or
where notability-mcp on Windows).
claude mcp add notability -s user -- notability-mcp servenotability-mcp setupThis adds the server to claude_desktop_config.json using the full path to notability-mcp, since Claude
Desktop doesn't see your shell's PATH. Restart Claude Desktop afterwards. To edit the file
yourself, open Settings > Developer > Edit Config.
Install in Cursor,
or add the config above to ~/.cursor/mcp.json.
Install in VS Code, or run:
code --add-mcp '{"name":"notability","command":"notability-mcp","args":["serve"]}'codex mcp add notability -- notability-mcp serveThen ask something like:
What did I write about struct allocation in CPSC 213?
Summarize my MATH 300 notes from last week.
Find the page where I worked out the harmonic conjugate and check my steps.
Tools
Tool | What it does |
| Fuzzy search over handwriting, typed text, PDF text and titles; returns pages with snippets |
| Lists notes by folder or recency, plus every folder and when you last synced |
| A note's text page by page, with pages where OCR looks unreliable flagged |
| One page as a PNG: your ink over the page's PDF |
All four are read-only.
Configuration
Variable | Default | Purpose |
| see below | Where the index is stored |
| keychain | Token for |
|
| Web app version to report, in case Notability starts rejecting old ones |
The index is stored in ~/Library/Application Support/notability-mcp on macOS,
%LOCALAPPDATA%\notability-mcp on Windows and ~/.local/share/notability-mcp on Linux.
Limitations
OCR is Apple's Vision framework on macOS and RapidOCR elsewhere. On 20 pages of handwritten math, Vision found 44% of the key words and 7% of the formulas; RapidOCR found 46% and 16%. Search will usually find the right page, but read the page image before trusting anything exact.
Page images show ink and PDF pages. Shapes, pasted images and typed text aren't drawn yet.
Notes other people shared with you aren't synced.
Audio recordings aren't transcribed or searched.
On Linux without a keyring (a headless server, say),
logincan't save the token. SetNOTABILITY_TOKENinstead.
Contributing
See CONTRIBUTING.md. To report a security problem, follow SECURITY.md instead of opening an issue.
Credits
The Notability wire format was reverse-engineered by notability-cli (MIT). See THIRD_PARTY_NOTICES.md.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
Search and read your own notes: insights, drafts, book and podcast notes. Read-only, OAuth.
Search, read, and safely update Markdown notes in your connected Phasoric knowledge vaults.
Search and manage your team's knowledge from MCP clients.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceCLI and MCP server to search and browse Apple Notes with fuzzy matching, full-text search, and PDF text extraction.15 npm8MIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to search, read, and list notes and tags in a Markdown vault using read-only tools.MIT
- AlicenseAqualityCmaintenanceLets MCP clients search iMessages, read Apple Notes including checklist state, and look up Contacts on macOS.12MIT
- FlicenseNot gradedqualityAmaintenanceEnables AI agents and MCP hosts to query a local hybrid index of scattered notes and documents, returning answers with section-level citations and exposing search, resources, and prompts.-