Skip to main content
Glama
Darkflib

Joplin MCP Server

by Darkflib

Joplin MCP Server

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.

Features

  • MCP Protocol Compliance: Standardized interface for AI assistant integration

  • Joplin API Integration: Direct connection to local or remote Joplin instances

  • Search Capabilities: Full-text search across notes, titles, and tags

  • Note Retrieval: Complete note content and metadata access

  • Notebook Navigation: Hierarchical notebook structure exploration

  • Rate Limiting: Respects Joplin API constraints

  • Error Handling: Graceful degradation during connection failures

Related MCP server: Joplin MCP Server

Installation

# Install from source
pip install -e .

# Install with development dependencies
pip install -e ".[dev]"

Configuration

Configure via environment variables:

export JOPLIN_API_URL="http://localhost:41184"
export JOPLIN_API_TOKEN="your-api-token-here"
export MCP_SERVER_PORT="3000"

Or create a .env file in the project root.

Usage

# Start the MCP server
joplin-mcp-server --port 3000

# With config file
joplin-mcp-server --config-file config.json

Development

# Setup development environment
python -m venv venv
source venv/bin/activate  # or venv\Scripts\activate on Windows
pip install -e ".[dev]"

# Install pre-commit hooks
pre-commit install

# Run tests
pytest

# Run linting
ruff check .
mypy src/

License

MIT

A
license - permissive license
Not graded
quality - not tested
D
maintenance

Maintenance

1Maintainers
No issuesResponse time
0Releases (12mo)

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

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
    165
    MIT
  • A
    license
    Not graded
    quality
    C
    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.
    70
    47
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Model Context Protocol (MCP) server for Joplin note-taking app, enabling AI to read, search, and modify notes via sandboxed scripts.
    2
    53
    26
    Apache 2.0

View all related MCP servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Darkflib/mcp-joplin'

If you have feedback or need assistance with the MCP directory API, please join our Discord server