Skip to main content

A Model Context Protocol (MCP) stdio server for Joplin, exposing Joplin's local REST API as MCP tools. Built with Python, uv, httpx, and FastMCP.

Project description

joplin-mcp-server

A Model Context Protocol (MCP) stdio server for Joplin, exposing Joplin's local REST API as MCP tools.

  • Tech stack: Python, uv, httpx, FastMCP
  • License: MIT

Features

  • Bridges Joplin's REST API to MCP tools
  • Designed for extensibility and integration

Quick Start

  1. Clone this repository
  2. Set up a Python 3.12+ environment (recommended: uv)
  3. Install dependencies: uv sync
  4. Run the server: uvx joplin-mcp-server

Project Structure

  • src/joplin_mcp_server/ — Main package code
  • specs/ — API documentation and references

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

joplin_mcp_server-0.1.3.tar.gz (4.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

joplin_mcp_server-0.1.3-py3-none-any.whl (4.7 kB view details)

Uploaded Python 3

File details

Details for the file joplin_mcp_server-0.1.3.tar.gz.

File metadata

  • Download URL: joplin_mcp_server-0.1.3.tar.gz
  • Upload date:
  • Size: 4.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for joplin_mcp_server-0.1.3.tar.gz
Algorithm Hash digest
SHA256 25750cc30453f13933c956732a0dc7848d5e8baf15647133293ce110af1f21cc
MD5 e69058f72148e462b10fac758a691156
BLAKE2b-256 76173a6ec9646d695eb65f286a06ebd4fef4766154a9f53a56d3c68c1b3a903e

See more details on using hashes here.

File details

Details for the file joplin_mcp_server-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: joplin_mcp_server-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 4.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for joplin_mcp_server-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 2a4c9d7e467ac942098230d8596f32f5dfbaf6907853903c80ece9a1a88e5154
MD5 46eb5051ac18b51cbc15d63a2eac2947
BLAKE2b-256 c658c63ea83207e171c2d867fafc3754bbc07e7038e7406e3a08f9e3c2d9488a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page