Joplin-mcp-server MCP Server

Search, read, create, edit and sync Joplin notes and notebooks via a headless Joplin sidecar.

Local serverstdio

What is the Joplin-mcp-server MCP Server?

Joplin-mcp-server is an MCP integration. Search, read, create, edit and sync Joplin notes and notebooks via a headless Joplin sidecar.

Packages and local setup

The published npm package is joplin-mcp-server, version 2.3.3. Its declared MCP transport is stdio.

The package declares JOPLIN_TOKEN: Joplin API token, for external mode only (see JOPLIN_HOST). Sidecar mode manages its own token and ignores this.; JOPLIN_HOST: Connect to an existing Joplin instance at this host instead of running a sidecar; JOPLIN_PORT: Port of the existing Joplin instance (default: 41184); JOPLIN_PROFILE: Joplin data directory for sidecar mode (default: ~/.config/joplin-mcp); JOPLIN_CLI: Path to the joplin CLI binary, overriding auto-detection; JOPLIN_SYNC_TARGET: Sync target: none, filesystem, webdav, nextcloud, joplin-cloud, joplin-server, s3, dropbox, onedrive (default: none); JOPLIN_SYNC_PATH: Sync target URL or path; the bucket name for the s3 target; JOPLIN_SYNC_USERNAME: Sync username or email; the access key for the s3 target; JOPLIN_SYNC_PASSWORD: Sync password; the secret key for the s3 target; JOPLIN_SYNC_REGION: S3 region (default: us-east-1); JOPLIN_SYNC_ENDPOINT: S3 endpoint URL for non-AWS providers such as Backblaze B2, MinIO, R2 or Wasabi (default: https://s3.amazonaws.com/); JOPLIN_SYNC_FORCE_PATH_STYLE: Use path-style S3 URLs, which self-hosted providers such as MinIO usually require: true or false (default: false); LOG_LEVEL: Log verbosity: debug, info, warn or error (default: info).

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 2.3.3 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related developer tools MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
JOPLIN_TOKENJoplin API token, for external mode only (see JOPLIN_HOST). Sidecar mode manages its own token and ignores this.Optional
JOPLIN_HOSTConnect to an existing Joplin instance at this host instead of running a sidecarOptional
JOPLIN_PORTPort of the existing Joplin instance (default: 41184)Optional
JOPLIN_PROFILEJoplin data directory for sidecar mode (default: ~/.config/joplin-mcp)Optional
JOPLIN_CLIPath to the joplin CLI binary, overriding auto-detectionOptional
JOPLIN_SYNC_TARGETSync target: none, filesystem, webdav, nextcloud, joplin-cloud, joplin-server, s3, dropbox, onedrive (default: none)Optional
JOPLIN_SYNC_PATHSync target URL or path; the bucket name for the s3 targetOptional
JOPLIN_SYNC_USERNAMESync username or email; the access key for the s3 targetOptional
JOPLIN_SYNC_PASSWORDSync password; the secret key for the s3 targetOptional
JOPLIN_SYNC_REGIONS3 region (default: us-east-1)Optional
JOPLIN_SYNC_ENDPOINTS3 endpoint URL for non-AWS providers such as Backblaze B2, MinIO, R2 or Wasabi (default: https://s3.amazonaws.com/)Optional
JOPLIN_SYNC_FORCE_PATH_STYLEUse path-style S3 URLs, which self-hosted providers such as MinIO usually require: true or false (default: false)Optional
LOG_LEVELLog verbosity: debug, info, warn or error (default: info)Optional