JotDrop for AI agents
Say "put milk and bread on my shopping list" to Claude, and it is on the list in the JotDrop app on your phone. Ask "when do the neighbours come back?" and your agent looks it up in your notes instead of guessing.
That works through jotdrop-mcp, a small open-source program you run yourself, on your own computer or server. It joins your JotDrop Cloud account as one more device, decrypts your notes in its own memory and offers them to your agent over the Model Context Protocol (MCP), the standard way for AI agents to use tools. Our server sees what it sees for every other app: encrypted files and a device name.
Before you connect
- This program holds the key to your notes. Run it only on a computer you trust as much as your phone.
- Your agent reads notes for you, so its AI provider sees what it reads. JotDrop still doesn't.
- Your agent can make and change notes. It can't delete, archive or share them, and older versions stay in each note's history.
- It counts as a device. You can remove it at any time under Connected devices.
Connect in two steps
- In JotDrop, open Connected devices (on app.jotdrop.net under Devices & recovery, or under JotDrop Cloud in the Android app) and choose Create pairing code. Give the device a name you'll recognise, like "Claude on my desktop". The code works for 10 minutes.
- In a terminal, run the line below and paste the code. You need Node.js 22 or newer.
npx -y jotdrop-mcp connect
You'll see something like Connected as "Claude on my desktop". 143 notes. and the lines to add it to your AI app. The key is never shown.
Add it to your AI app
Claude Code
claude mcp add --transport stdio jotdrop -- npx -y jotdrop-mcp
Claude Desktop
In claude_desktop_config.json (Settings, Developer, Edit config), under "mcpServers", then restart Claude Desktop:
"jotdrop": { "command": "npx", "args": ["-y", "jotdrop-mcp"] }
On Windows, if Claude Desktop can't start npx, use "command": "cmd", "args": ["/c", "npx", "-y", "jotdrop-mcp"].
Cursor
The same block in .cursor/mcp.json, under "mcpServers".
OpenClaw and other clients
Anything that starts a program over stdio: the command is npx -y jotdrop-mcp.
Hermes Agent and other agents in Docker
Run jotdrop-mcp as its own container on the internal Docker network and let the agent talk to it over HTTP with a token. In ~/.hermes/config.yaml:
mcp_servers:
jotdrop:
url: http://jotdrop-mcp:8765/mcp
headers: { Authorization: "Bearer ${JOTDROP_MCP_TOKEN}" }
tools: { include: [search_notes, read_note, list_labels, create_note, append_to_note] }
Please keep that port off the open internet. The README has the Dockerfile, the token and the one-time connect command.
What your agent can do
| Tool | What it does |
|---|---|
search_notes | Search notes by words, archived ones too, never the trash. An empty search lists the newest. |
read_note | The full text of one note. |
list_labels | The labels you already use. |
create_note | A new note with a title, text and checklist items. |
append_to_note | Text or checklist items at the end of a note, like milk on a shopping list. |
replace_note_text | Replace the whole text. Marked as destructive, so clients that can will ask you first. |
set_labels | The labels of a note, picked from the ones you have. |
set_reminder | A reminder at a local date and time. |
set_expiry | The date a receipt or warranty runs out. The note goes into the Paper drawer with a reminder a week before. |
Want fewer? Start it with --tools, for example --tools search_notes,read_note,list_labels,create_note,append_to_note. A #word your agent writes stays text and never becomes a tag. The program allows 60 tool calls and 20 changes a minute, which slows down an agent stuck in a loop.
Your phone shows the change when the app syncs: as soon as you open it, or within about 15 minutes in the background. The web app shows it right away.
Questions
Does it count as a device?
Yes. It joins your account as one more device, with the name you give it. On the free plan that is one of your two devices; with Plus the device limit doesn't apply. Remove it under Connected devices and it stops at once.
Does JotDrop see my notes?
No. jotdrop-mcp decrypts your notes on the computer where you run it, like the app on your phone does. Our server still only gets encrypted files. The AI service behind your agent does see what the agent reads, under your agreement with that service, so pick an agent and a provider you trust. The privacy policy says the same.
Which agents work?
Any agent that speaks MCP, over stdio or over HTTP on your own network. We tried Claude Code, Claude Desktop and Hermes Agent ourselves; Cursor and OpenClaw take the same settings. ChatGPT and claude.ai connectors need a public server with OAuth, and this version doesn't offer that.
Can my agent delete notes?
No. There is no tool for deleting, archiving or sharing notes. Your agent can make notes and change them. Replacing the whole text of a note is marked as destructive, so clients that ask before such a step will ask you, and the earlier versions stay in the note's history.
What does it cost?
jotdrop-mcp is free and open source under the MIT licence. It works with every JotDrop Cloud plan, Free included. Your AI agent and its provider may cost money on their side.
What if a note tells my agent to do something?
Notes go to your agent as data, with the reminder that note contents are not instructions. jotdrop-mcp itself has no way to send anything outside your notes or to delete them. Your agent may have other tools, such as web search or email, so be careful which tools you combine with your notes. More on that in Give your AI agent a notebook: what it can see, and what we can't.
Get it
- jotdrop-mcp on npm, version 0.1.0.
- Source code and README on GitHub, MIT licence.
- No JotDrop Cloud account yet? Start free. Every new account gets 14 days of Plus, no card needed.