JotDrop
Log inStart free

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

Connect in two steps

  1. 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.
  2. 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

ToolWhat it does
search_notesSearch notes by words, archived ones too, never the trash. An empty search lists the newest.
read_noteThe full text of one note.
list_labelsThe labels you already use.
create_noteA new note with a title, text and checklist items.
append_to_noteText or checklist items at the end of a note, like milk on a shopping list.
replace_note_textReplace the whole text. Marked as destructive, so clients that can will ask you first.
set_labelsThe labels of a note, picked from the ones you have.
set_reminderA reminder at a local date and time.
set_expiryThe 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