Provides full CRUD over Joplin notes, notebooks, tags, and resources, plus search, note revision history, and connectivity check, enabling AI agents to manage a Joplin note-taking instance.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Agentic-Joplin MCP Server Create a note in my Work notebook titled 'Meeting notes' with content 'Discussed Q2 goals.'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Tooling that lets coding agents integrate with Joplin, the open-source note-taking app.
The project has three planned pieces:
Piece | Status |
MCP server — wraps Joplin's Data API as Model Context Protocol tools | ✅ Phase 1 complete |
Joplin plugin — in-app plugin for capabilities the Data API can't expose | 🔜 planned |
Agent skills — skill files teaching agents how to use Joplin effectively | ✅ Claude Code + Codex plugin |
This repo is an npm-workspaces monorepo; each piece lives under packages/.
packages/mcp-server is a from-scratch Model Context Protocol server (TypeScript, stdio transport) that gives an agent full CRUD over Joplin notes, notebooks, tags, and resources, plus search, note revision history, and a connectivity check — 26 tools across 7 groups. It wraps Joplin's local Data API (the REST service exposed by the desktop app's Web Clipper).
Node.js ≥ 20
Joplin desktop running with the Web Clipper service enabled (Options → Web Clipper), and an API token generated there.
npm install
npm run build --workspace @agentic-joplin/mcp-serverThen add it to your MCP client (e.g. Claude Code / Claude Desktop) as a stdio server running node packages/mcp-server/dist/index.js, with these environment variables:
Variable | Required | Default | Description |
| yes | — | API token from Joplin's Web Clipper settings |
| no |
| Host of the Web Clipper service |
| no |
| Port of the Web Clipper service |
Joplin must be running with Web Clipper enabled for any tool call to succeed.
Notes (create_note, get_note, update_note, delete_note, list_notes), notebooks (get_notebook, list_notebooks, create_notebook, update_notebook, delete_notebook), tags (get_tag, list_tags, create_tag, update_tag, delete_tag, tag_note, untag_note), search (find_notes), resources (attach_resource, get_resource, update_resource, delete_resource, list_note_resources), revisions (list_note_revisions, delete_note_revisions), and ping.
Notes can be created in Markdown (default) or HTML via a format parameter. See packages/mcp-server/README.md for the full per-tool reference and packages/mcp-server/SMOKE_TEST.md for the manual release checklist.
Related MCP server: Joplin MCP Server
packages/plugin is a single plugin — valid for both Claude Code and
Codex — that bundles the Joplin MCP server with four agent skills (using-joplin hub plus
joplin-capturing-notes, joplin-searching-and-updating, joplin-organizing). See
packages/plugin/README.md for install steps on each platform.
npm run build # type-check + compile all workspaces
npm test # run all workspace unit tests (mocked Data API, no Joplin instance needed)Design docs live under docs/superpowers/: the design spec and the implementation plan.
TBD.
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.
User-owned memory for AI agents, Copilot, Claude, IDEs, CLIs, and chat apps over remote MCP.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/sohampatwardhan/Agentic-Joplin'
If you have feedback or need assistance with the MCP directory API, please join our Discord server