joplin-mcp-go
v0.0.3
Published
Go implementation of a Joplin MCP server, runnable through npx.
Downloads
461
Readme
joplin-mcp
Go implementation of a Joplin MCP server. It runs locally as a single binary over MCP stdio and talks to the Joplin Web Clipper REST API.
Build
make buildRun
With npm:
JOPLIN_TOKEN=your_token npx joplin-mcpThe npm package is a thin launcher around the prebuilt Go binary for the current platform.
JOPLIN_TOKEN=your_token ./joplin-mcpFor local development:
make dev
make dev ARGS="-token your_token -base-url http://localhost:41184"Options:
./joplin-mcp -token your_token -base-url http://localhost:41184Token resolution priority:
-tokenJOPLIN_TOKENenvironment variable.envfile next to thejoplin-mcpbinary withJOPLIN_TOKEN=....envfile in the current working directory
Available MCP tools:
search_notesget_notecreate_noteupdate_notedelete_noteimport_markdown
npm Release
Pushing a tag in vx.x.x format triggers GitHub Actions to publish the npm package. The package version is derived from the tag by removing the leading v.
git tag v0.1.0
git push origin v0.1.0To create the npm package locally:
npm packnpm pack runs make npm-package first and includes prebuilt Go binaries for Linux, macOS, and Windows.
Checks
make test