Skip to main content
Glama
joplin-mcp

joplin-mcp

by songtianlun

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 build

Related MCP server: Joplin MCP Server

Run

With npm:

JOPLIN_TOKEN=your_token npx joplin-mcp

The npm package is a thin launcher around the prebuilt Go binary for the current platform.

JOPLIN_TOKEN=your_token ./joplin-mcp

For 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:41184

Token resolution priority:

  1. -token

  2. JOPLIN_TOKEN environment variable

  3. .env file next to the joplin-mcp binary with JOPLIN_TOKEN=...

  4. .env file in the current working directory

Available MCP tools:

  • search_notes

  • get_note

  • create_note

  • update_note

  • delete_note

  • import_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.0

To create the npm package locally:

npm pack

npm pack runs make npm-package first and includes prebuilt Go binaries for Linux, macOS, and Windows.

Checks

make test

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      Enables AI assistants to interact with Joplin notes, notebooks, and tags through a standardized MCP interface, supporting CRUD operations, search, and organization.
      19
      131 PyPI
      174
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      MCP server that provides standardized tools for querying and retrieving notes from Joplin personal knowledge manager through its API, enabling AI assistants to access and reference personal notes contextually.
      9
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with Joplin notes and notebooks, including searching, reading, and listing notebooks through natural language commands via the MCP protocol.
      169 npm
      50
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      A minimal MCP server that enables interaction with Joplin notes and notebooks through the local Web Clipper REST API, providing tools for search, create, update, and note management.
      13
      MIT