Skip to main content
Glama

Obsidian MCP Server

by engineers-hub-ltd-in-house-project
npmGitHub
JavaScript
MIT License
248
  • Linux
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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 Host を 0.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を作成して変更内容について議論してください。

This server cannot be installed

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

How are these scores calculated?

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. Obsidianの設定
        2. Vault のGit設定（オプション）
        3. MCPサーバーのインストール
        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

              • apple-notes-mcp

                sirmews
                -
                security
                A
                license
                -
                quality
                Allows the AI to read from your local Apple Notes database (macOS only)
                Last updated -
                56
                Python
                MIT License
                • Apple

              • obsidian-mcp

                StevenStavrakis
                -
                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 -
                598
                149
                TypeScript
                MIT License
                • Apple

              • Obsidian MCP REST Server

                PublikPrinciple
                -
                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 -
                37
                TypeScript
                MIT License

              • Obsidian MCP

                takuya0206
                -
                security
                A
                license
                -
                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 -
                598
                TypeScript
                ISC License

              View all related MCP servers

              New 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