joplin-mcp-server 0.1.0__py3-none-any.whl

__init__.py

@@ -0,0 +1 @@
+# src package marker

joplin_mcp_server/__init__.py

@@ -0,0 +1 @@
+# joplin_mcp_server package marker

joplin_mcp_server/entry.py

@@ -0,0 +1,32 @@
+"""
+entry.py
+A FastMCP server entry point for listing Joplin folders.
+"""
+
+import asyncio
+import os
+
+from fastmcp import FastMCP
+
+from .joplin_client import JoplinClient
+
+mcp = FastMCP(name="Joplin MCP Server")
+
+# Get token from environment variable for security
+JOPLIN_TOKEN = os.environ.get("JOPLIN_TOKEN", "")
+joplin = JoplinClient(base_url="http://localhost:41184", token=JOPLIN_TOKEN)
+
+
+@mcp.tool
+def list_folders() -> dict:
+    """List all Joplin folders (notebooks) using the Joplin API."""
+
+    return asyncio.run(joplin.get_folders())
+
+
+def main():
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()

joplin_mcp_server/joplin_client.py

@@ -0,0 +1,39 @@
+"""
+joplin_client.py
+A client for interacting with the Joplin API.
+
+This module provides a simple asynchronous client to interact with the Joplin API.
+"""
+
+from typing import Any
+
+import httpx
+
+
+class JoplinClient:
+    """
+    A client for interacting with the Joplin API.
+    """
+
+    def __init__(
+        self, base_url: str = "http://localhost:41184", token: str = ""
+    ) -> None:
+        self.base_url = base_url.rstrip("/")
+        self.token = token
+
+    def _url(self, path: str) -> str:
+        sep = "&" if "?" in path else "?"
+        return f"{self.base_url}{path}{sep}token={self.token}"
+
+    async def get_folders(self) -> dict[str, Any]:
+        """
+        Fetches the list of folders from the Joplin API.
+
+        Returns:
+            dict[str, Any]: A dictionary containing the folders.
+        """
+
+        async with httpx.AsyncClient() as client:
+            resp = await client.get(self._url("/folders"))
+            resp.raise_for_status()
+            return resp.json()

joplin_mcp_server-0.1.0.dist-info/METADATA

@@ -0,0 +1,50 @@
+Metadata-Version: 2.4
+Name: joplin-mcp-server
+Version: 0.1.0
+Summary: 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.
+Author-email: Zeyang Lin <4020306+linzeyang@users.noreply.github.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/linzeyang/joplin-mcp-server
+Project-URL: Documentation, https://github.com/linzeyang/joplin-mcp-server#readme
+Keywords: joplin,mcp,server,rest api,notes,python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Development Status :: 3 - Alpha
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: fastmcp==2.8.1
+Requires-Dist: httpx==0.28.1
+Dynamic: license-file
+
+# 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.10+ environment (recommended: `uv`)
+3. Install dependencies: `uv pip install -r pyproject.toml`
+4. Run the server: `uvx joplin-mcp-server`
+
+## Project Structure
+- `src/joplin_mcp_server/` — Main package code
+- `specs/` — API documentation and references
+
+## License
+MIT

joplin_mcp_server-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+__init__.py,sha256=DjKJSPFBjFMWIB1WSdQIB3K3TI7d9Bk0H0xOJpuDrUI,21
+joplin_mcp_server/__init__.py,sha256=e2iGMbIaofQC9CGoV8F1RrkdtnDK8Us_pj6ff0C08aA,35
+joplin_mcp_server/entry.py,sha256=m9h4bkJTxkJQU_EUh6ebq1GyOFtC-lpDJ4GBa2wXl4s,612
+joplin_mcp_server/joplin_client.py,sha256=mCqHbFSzcWm_Fq1iuRTlgYLq53ZLWLK_7wzspl_hAps,996
+joplin_mcp_server-0.1.0.dist-info/licenses/LICENSE.md,sha256=H2a-nobfdapdoFZcyOw70l7d9E9NChOpE8dQ-qZM5hw,1067
+joplin_mcp_server-0.1.0.dist-info/METADATA,sha256=Fw14cCvfspHVMBQHTeqAHGVs1p-SGvp_Q6ebAF9CyRU,1866
+joplin_mcp_server-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+joplin_mcp_server-0.1.0.dist-info/entry_points.txt,sha256=VLkk0zkiRiHVJbVymY2z0APqib3Sk1C6Pq8ll9XyDcM,67
+joplin_mcp_server-0.1.0.dist-info/top_level.txt,sha256=B6cW1I_mDJXOjgA8YyiBlzICbKnjriis2Qt1Gi1OSYY,27
+joplin_mcp_server-0.1.0.dist-info/RECORD,,

joplin_mcp_server-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

joplin_mcp_server-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+joplin-mcp-server = joplin_mcp_server.entry:main

joplin_mcp_server-0.1.0.dist-info/licenses/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Zeyang Lin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

joplin_mcp_server-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+__init__
+joplin_mcp_server