Joplin MCP Server

📝 Joplin MCP サーバー

Joplin用のモデルコンテキストプロトコル（MCP）サーバー。モデルコンテキストプロトコルを介してノートへのアクセスを可能にします。ClaudeのようなAIアシスタントとの統合に最適です。

✨ 特徴

• 🔍ノートの検索：すべてのノートを全文検索
• 📖ノートを読む：個々のノートを取得する
• ✏️ノートの編集: 新しいノートを作成し、既存のノートを更新します
• 🗑️メモの削除：メモをゴミ箱に移動するか、完全に削除します
• 📥 Markdownインポート：Markdownファイルをノートとしてインポート
• 🤖 AI統合：Claudeやその他のMCP対応AIアシスタントとのシームレスな統合

🚀 インストール

前提条件

• Python 3.10以上
• Web クリッパー サービスが有効になっているJoplin Desktop
• uv (Python パッケージ マネージャー)

⚙️ 構成

Joplin APIトークン

1. Joplinデスクトップを開く
2. ツール -> オプション -> Webクリッパーに移動します
3. Webクリッパーサービスを有効にする
4. APIトークンをコピーする

プロジェクト ディレクトリに.envファイルを作成します。

クロードデスクトップセットアップ

1. Claude Desktopをインストールする
   • Claude Desktopをダウンロード
   • 最新バージョンであることを確認してください (メニュー: Claude -> 更新の確認...)
2. MCPサーバーを構成する
   { "mcpServers": { "joplin": { "command": "/PATH/TO/UV/uv", "args": [ "--directory", "/PATH/TO/YOUR/PROJECT/joplin_mcp", "run", "src/mcp/joplin_mcp.py" ] } } }
   • /PATH/TO/UV/uv UVインストールの絶対パスに置き換えます。
     • パスを見つける: which uv
     • macOSの例: /Users/username/.local/bin/uv
     • Windows の例: C:\Users\username\AppData\Local\Microsoft\WindowsApps\uv.exe
   • /PATH/TO/YOUR/PROJECT/joplin_mcpプロジェクトの絶対パスに置き換えます。

   重要: Claude Desktop はシェル環境変数にアクセスできないため、 uvへのフルパスが必要です。

🛠️ 利用可能なツール

検索ノート

Joplin でノートを検索します。

パラメータ:

• query (文字列): 検索クエリ
• limit (int, オプション): 結果の最大数 (デフォルト: 100)

メモを取得する

ID で特定のメモを取得します。

パラメータ:

• note_id (文字列): ノートのID

ノートを作成

新しいメモを作成します。

パラメータ:

• title (文字列): ノートのタイトル
• body (文字列、オプション): Markdown でのメモ内容
• parent_id (文字列、オプション): 親フォルダのID
• is_todo (ブール値、オプション): これがToDo項目であるかどうか

更新ノート

既存のメモを更新します。

パラメータ:

• note_id (文字列): 更新するノートのID
• title (文字列、オプション): 新しいタイトル
• body （文字列、オプション）: 新しいコンテンツ
• parent_id (文字列、オプション): 新しい親フォルダID
• is_todo (ブール値、オプション): 新しいToDoステータス

削除メモ

メモを削除します。

パラメータ:

• note_id (文字列): 削除するノートのID
• permanent （ブール値、オプション）：trueの場合、メモを完全に削除します

インポートマークダウン

マークダウン ファイルを新しいノートとしてインポートします。

パラメータ:

• file_path (文字列): マークダウンファイルへのパス

🧪 開発

デバッグモード

サーバーをデバッグ モードで起動するには:

これにより、http://localhost:5173で MCP Inspector が起動し、ツールをテストできるようになります。

📄 ライセンス

MITライセンス- 著作権 (c) 2025 David Weigend

👤 著者

デビッド・ワイゲンド

• ウェブサイト: weigend.studio
• GitHub: @dweigend

🤝 貢献する

貢献、問題、機能のリクエストを歓迎します。問題ページにアクセスしてください。