Skip to main content
Glama

Obsidian MCP Server

ObsidianをAIから操作するためのMCP (Model Context Protocol) サーバーです。 Obsidian Local REST APIを使用してノートの作成・更新・検索を行い、Git連携により自動的にバックアップを行います。

🚀 機能

  • ノート管理
    • 新規ノートの作成
    • 既存ノートの読み取り・更新・削除
    • フォルダ内のノート一覧取得
  • Daily Note連携
    • 今日のDaily Noteへの追記
    • タイムスタンプ付き記録
  • 検索機能
    • キーワードによるノート検索
    • 検索結果の件数制限
  • Git自動同期
    • 変更時の自動コミット
    • GitHubへの自動プッシュ
  • 構造化コンテンツ作成
    • 記事作成(フロントマター付き)
    • テンプレートからの作成
    • カテゴリー・タグ管理

📋 前提条件

  1. Obsidian
    • Local REST API プラグインがインストール・有効化されていること
    • APIキーが生成されていること
  2. Git (自動同期を使用する場合)
    • Vaultディレクトリがgitリポジトリとして初期化されていること
    • リモートリポジトリが設定されていること
  3. Node.js
    • バージョン18以上

🛠️ セットアップ

1. Obsidianの設定

  1. Obsidianを開き、設定 → コミュニティプラグイン → ブラウズ
  2. "Local REST API"を検索してインストール
  3. プラグインを有効化
  4. Local REST APIの設定を開き、"Copy API Key"でAPIキーをコピー

2. Vault のGit設定(オプション)

cd /path/to/your/vault git init git remote add origin https://github.com/username/obsidian-vault.git git add . git commit -m "Initial commit" git push -u origin main

3. MCPサーバーのインストール

# 依存関係のインストール cd obsidian-mcp-server npm install # 環境変数の設定 cp .env.example .env # .envファイルを編集して、APIキーとVaultパスを設定

4. Claude Codeへの登録

Windows 11 + WSL2環境の場合
# WSL2内で実行 claude mcp add obsidian "node /home/yusuke/engineers-hub.ltd/in-house-project/obsidian-mcp-server/src/index.js" \ -e OBSIDIAN_API_URL="https://172.24.80.1:27124" \ -e OBSIDIAN_API_KEY="your-api-key" \ -e VAULT_PATH="/mnt/c/Users/YourName/Documents/ObsidianVault" \ -e GIT_AUTO_SYNC="false"

重要な設定ポイント:

  • OBSIDIAN_API_URL: WSL2からWindows側のObsidianに接続するため、Windows側のIPアドレスを使用
    • IPアドレスは ip route | grep default | awk '{print $3}' で確認
  • Obsidianの設定で Binding Host0.0.0.0 に変更(デフォルトは127.0.0.1)
  • HTTPS自己署名証明書を使用しているため、MCPサーバーは証明書検証をスキップします
通常のLinux/Mac環境の場合
claude mcp add obsidian "node /path/to/obsidian-mcp-server/src/index.js" \ -e OBSIDIAN_API_KEY="your-api-key" \ -e VAULT_PATH="/path/to/vault" \ -e GIT_AUTO_SYNC="true"

🔧 環境変数

変数名説明デフォルト値
OBSIDIAN_API_URLObsidian Local REST APIのURLhttp://localhost:27123
OBSIDIAN_API_KEYObsidianのAPIキー(必須)
VAULT_PATHObsidianのVaultパス(Git同期時は必須)
GIT_AUTO_SYNCGit自動同期の有効/無効false
LOG_LEVELログレベルinfo

📝 使用例

Claude Codeでの使用例

1. 新規ノート作成

"プロジェクトの要件定義をObsidianに保存して"

2. Daily Noteへの追記

"今日の会議の議事録をDaily Noteに追加"

3. ノート検索

"Tech Guildに関するノートを検索して"

4. 週次レポート作成

"今週のDaily Notesから重要な項目をまとめて週次レポートを作成"

5. 構造化記事の作成

"Obsidianの使い方についての記事を作成。カテゴリーはTutorial、タグは[Obsidian, PKM]で"

🛡️ 利用可能なツール

createNote

新しいノートを作成します。

パラメータ:

  • title (必須): ノートのタイトル
  • content (必須): ノートの内容(Markdown形式)
  • folder (オプション): 保存先フォルダ(デフォルト: "Notes")

appendToDaily

今日のDaily Noteに内容を追記します。

パラメータ:

  • content (必須): 追記する内容
  • timestamp (オプション): タイムスタンプを付けるか(デフォルト: true)

searchNotes

ノートを検索します。

パラメータ:

  • query (必須): 検索クエリ
  • limit (オプション): 最大結果数(デフォルト: 10)

readNote

ノートの内容を読み取ります。

パラメータ:

  • path (必須): ノートのパス

updateNote

既存のノートを更新します。

パラメータ:

  • path (必須): ノートのパス
  • content (必須): 新しい内容

deleteNote

ノートを削除します。

パラメータ:

  • path (必須): ノートのパス

listNotes

フォルダ内のノート一覧を取得します。

パラメータ:

  • folder (オプション): フォルダパス(デフォルト: "/")

createArticle

構造化された記事を作成します。

パラメータ:

  • title (必須): 記事タイトル
  • category (必須): カテゴリー
  • content (必須): 記事内容
  • tags (オプション): タグの配列
  • draft (オプション): 下書きフラグ(デフォルト: true)

createFromTemplate

テンプレートからノートを作成します。

パラメータ:

  • templateType (必須): テンプレートタイプ(article, weeklyReport, projectDoc)
  • title (必須): タイトル
  • category (オプション): カテゴリー(記事の場合)

🧪 開発

# 開発モード(ファイル変更監視) npm run dev # テスト実行 npm test # 接続テスト node test-connection.js

📄 ライセンス

MIT

🤝 貢献

プルリクエストを歓迎します!大きな変更の場合は、まずissueを作成して変更内容について議論してください。

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Allows AI models to interact with Obsidian notes through the Local REST API, enabling creation, reading, updating, searching of notes, and Git-based automatic backups.

  1. 🚀 機能
    1. 📋 前提条件
      1. 🛠️ セットアップ
        1. 1. Obsidianの設定
        2. 2. Vault のGit設定(オプション)
        3. 3. MCPサーバーのインストール
        4. 4. Claude Codeへの登録
      2. 🔧 環境変数
        1. 📝 使用例
          1. Claude Codeでの使用例
        2. 🛡️ 利用可能なツール
          1. createNote
          2. appendToDaily
          3. searchNotes
          4. readNote
          5. updateNote
          6. deleteNote
          7. listNotes
          8. createArticle
          9. createFromTemplate
        3. 🧪 開発
          1. 📄 ライセンス
            1. 🤝 貢献

              Related MCP Servers

              • -
                security
                A
                license
                -
                quality
                Enables AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags.
                Last updated -
                328
                474
                TypeScript
                MIT License
                • Apple
              • -
                security
                A
                license
                -
                quality
                Provides a standardized interface for AI assistants to interact with Obsidian vaults through a local REST API, enabling reading, writing, searching, and managing notes.
                Last updated -
                51
                TypeScript
                MIT License
              • A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that enables AI assistants to read, write, and manipulate notes in your Obsidian vault through a standardized interface.
                Last updated -
                5
                328
                2
                TypeScript
                ISC License
              • -
                security
                A
                license
                -
                quality
                A server implementation that allows AI assistants to read, create, and manipulate notes in Obsidian vaults through the Model Context Protocol.
                Last updated -
                1,025
                5
                TypeScript
                MIT License

              View all related MCP servers

              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/engineers-hub-ltd-in-house-project/obsidian-mcp-server'

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