bytefrost-joplin-mcp

bytefrostdev/bytefrost-joplin-mcp

3.1

If you are the rightful owner of bytefrost-joplin-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Bytefrost Joplin MCP is a server that integrates AI assistants with Joplin notes via direct database access.

🚧 UNDER DEVELOPMENT - NOT PRODUCTION READY 🚧

Warning: This project is under active development and is NOT ready for production use. APIs, database queries, and functionality may change without notice.

Bytefrost Joplin MCP

A Model Context Protocol (MCP) server that gives AI assistants (Claude, etc.) direct access to your Joplin notes via your self-hosted Joplin Server.

What is this?

Bytefrost Joplin MCP lets you:

  • 🔍 Search your Joplin notes with natural language
  • 📖 Read notes, notebooks, and tags
  • ✏️ Create and edit notes directly from your AI assistant
  • 🏷️ Organize with tags and notebooks

Why direct database access?

Joplin's existing APIs have limitations:

  • REST API: Only available on desktop client (requires running app)
  • Server API: Designed for sync protocol, not direct data access
  • Client dependency: Most integrations require a running Joplin app

This MCP connects directly to the PostgreSQL database, enabling true server-side automation without any client dependency.

Target Audience

This project is for you if you:

  • ✅ Run a self-hosted Joplin Server with PostgreSQL
  • ✅ Want to integrate your notes with AI assistants via MCP
  • ✅ Are comfortable with Docker and terminal

Not supported:

  • ❌ Joplin Cloud (no database access)
  • ❌ Local Joplin Desktop only (uses SQLite, not PostgreSQL)
  • ❌ Mobile app only

Requirements

  • Joplin Server ≥ 2.6.0 (self-hosted)
  • PostgreSQL database (comes with Joplin Server docker-compose)
  • Docker (recommended) or Python 3.11+ runtime

Installation

🚧 Coming soon

Configuration

🚧 Coming soon

Usage

🚧 Coming soon

Documentation

See for technical documentation about:

  • Database schema and items table structure
  • Item types (notes, notebooks, tags, etc.)
  • JSON content format parsing
  • SQL query examples
  • Sync protocol considerations

License

MIT License - see

Contributing

This project is open source and contributions are welcome! Since the project is still in early development, please open an issue before starting on larger changes.

Made with ☕ by Bytefrost