Your notes. Your AI agent.
Use the Claude Code or Codex Mac app to work with your Jotley notes. Pick what your agent can do and which app you use to see how to set it up.
Jotley
Mac onlyOff by defaultFree
Your agent can list, search and read your notes, including titles, dates, tags, transcripts and summaries.
Nothing in your library changes. Agents work with the library open in Jotley, including notes synced from your iPhone or iPad.
Search my Jotley notes for release planning and tell me who owns each action.
Everything in Read only, plus creating, editing, copying and deleting notes and managing tags, folders and summary templates.
Review your agent’s approvals before it makes changes. Deletion is permanent, so try it on a test note first.
Rename that note Launch checklist and rewrite its summary as action items. Keep the transcript unchanged.
Connect Jotley with
- Open Jotley’s Settings gear, then choose Integrations → MCP.
- Turn on Enable MCP access. Wait for Server ready and keep Jotley open.
- Choose Read only, then click Test connection to check Jotley’s server.
- Still in Jotley’s MCP settings, choose Claude Code app → Save project connection… and select your project folder.
- Open the Claude Mac app’s Code tab. Start a local session on This computer using that same folder.
- Review Claude’s project trust prompt and approve Jotley. Open the session’s Connectors panel and check Jotley. Start a new session if the project was already open.
Using regular Claude chat instead?
Use the Code tab for this connection. Regular Claude chat uses the separate extension available under Jotley’s advanced setup options.
- Open Jotley’s Settings gear, then choose Integrations → MCP.
- Turn on Enable MCP access. Wait for Server ready and keep Jotley open.
- Choose Read only, then click Test connection to check Jotley’s server.
- Still in Jotley’s MCP settings, choose Codex app.
- In Codex, open Settings → MCP servers → Add server. Name it
jotleyand choose STDIO. - Copy Command from Jotley into Codex’s Command field without extra quotes.
- Add one argument:
--mcp-stdio. Leave environment variables empty. - Save, restart the server, then start a local chat. Type
/mcpto check Jotley.
Moved Jotley to another folder?
Moving the app changes its launch path. Update the Command path in Codex with the current value from Jotley.
Before you connect
How the connection works
MCP is the connection between Jotley and your agent. It runs on your Mac while Jotley is open, and setup happens in the apps. No separate runtime or copied token is needed.
MCP is unavailable on iPhone or iPad, and cloud sessions cannot reach this local connection.
Your notes and your agent’s AI provider
Access is off by default, and you can turn it off in Jotley at any time. The connection itself stays on your Mac, but connected agents may send retrieved notes to their AI provider or retain copies.
Read only or Read & write
Read only lets your agent search and read. Read & write also lets it create, edit, copy and delete notes and manage tags, folders and templates. Deletion is permanent.
You can switch between them in Jotley’s MCP settings whenever you like.
Checking that it works
After a change, open the note in Jotley to see what was saved. Last agent seen and Last successful request in Jotley’s MCP settings show actual connection activity.
If you move Jotley, update the Command path in Codex or save the Claude Code project connection again.
What it costs
All note-taking features, including Mac MCP, are free. Personal technical support and tips are optional paid purchases.
