Obsidian Vault MCP
Obsidian Vault MCP(無料、カード不要、常時稼働のコンピュータ不要)
これにより、Claude(モバイル、デスクトップ、ウェブ)があなたのObsidian vaultに読み取りアクセスできるようになります。 Renderで無料ホスティングされる小さなサーバーを介し、GitHubリポジトリから直接読み取ります。 vaultは、Obsidian Gitプラグインを介してスマートフォンとデスクトップからGitHubに同期されます。電源を入れ続ける必要はありません。
構成要素
GitHubリポジトリ — vaultの信頼できる情報源(無料、プライベート)。
Obsidian Gitプラグイン — デスクトップとスマートフォンから自動コミット/プッシュ/プルを行います。
このMCPサーバー — GitHubのAPIを介してリポジトリを読み取り、
list_notes、read_note、search_notesをMCP経由で公開します。Renderに無料デプロイ。Graphify — オプションで、ローカルで実行し、その出力を他のメモと同様にリポジトリにコミットします。
Related MCP server: Obsidian MCP Server
1. GitHubリポジトリを作成する
github.com → New repository → 例:
obsidian-vaultと名前を付け → Private → Create。Settings → Developer settings → Personal access tokens → Fine-grained token:
Repository access: このリポジトリのみ。
Permissions: Contents → Read and write(Claudeがメモを作成および編集できるようにするため、読み取りだけでなく書き込みも必要)。
トークンをコピーします — Renderで
GITHUB_TOKENとして貼り付けます。
2. Obsidian Gitをセットアップする(デスクトップ + スマートフォン)
Obsidian → Settings → Community plugins → 閲覧 → Obsidian Git をインストール。
vaultフォルダをリポジトリのローカルクローンにポイントする(またはその場で
git initし、GitHubリポジトリをoriginとして追加する)。プラグイン設定で、auto backup on interval(例: 10分ごと)と auto pull on load をオンにします — 自動的にコミット + プッシュ + プルを行います。
スマートフォンの場合: Obsidianモバイルをインストールし、同じプラグインを追加(iOS/Androidで動作します)、プラグインの認証画面でGitHubにサインインします。
これで、すべてのデバイスが同じリポジトリにプッシュ/プルするようになります。そのリポジトリが同期レイヤーです。
3. MCPサーバーをRenderにデプロイする(無料)
このフォルダ(
server.js、package.json、render.yaml)を、独自の公開または非公開のGitHubリポジトリ(vaultリポジトリとは別)にプッシュします。render.com → New → Web Service → そのリポジトリを接続。
render.yamlを自動検出するはずです。しない場合: Build commandnpm install、Start commandnpm start、プラン Free。環境変数を追加:
GITHUB_TOKEN— ステップ1の fine-grained tokenGITHUB_OWNER— あなたのGitHubユーザー名GITHUB_REPO— あなたのvaultリポジトリ名(例:obsidian-vault)GITHUB_BRANCH—main(またはデフォルトブランチ)MCP_SHARED_SECRET— ランダムな文字列を作成; これにより、あなたのRender URLを見つけた見知らぬ人がvaultを読むのを防ぎます
デプロイ。
https://obsidian-vault-mcp.onrender.comのようなURLが発行されます。
無料ティアに関する注意: 約15分間アイドル状態が続くとスリープし、次のリクエストで起動するのに数秒かかります — たまのClaudeクエリには問題ありません。
4. Claudeに接続する
Claude → Settings → Connectors → Add custom connector:
URL:
https://<あなたのアプリ>.onrender.com/mcpHeader:
Authorization: Bearer <あなたの MCP_SHARED_SECRET>
その後、Claudeにメモの検索、読み取り、編集を依頼するだけで、自動的に search_notes / read_note / list_notes / write_note / delete_note が呼び出されます。書き込みはリポジトリに直接コミットされるため、次回Obsidian Gitが同期するときにスマートフォン/デスクトップに表示されます(または、auto-pull-on-intervalがオンになっている場合は即座に表示されます)。
書き込みに関する注意: write_note はファイル全体を上書きします — 既存のメモを編集する場合は、まずClaudeに読み取らせ、その後、更新された完全なコンテンツを書き戻させてください。delete_note は実際の永続的なgitコミットです。削除する前にClaudeに確認を求めることをお勧めします。
5. Graphify — 自動、無料、ホスティング不要
Graphifyはメモからナレッジグラフを構築します。セマンティック抽出にはLLMが必要で、ホスティングが不要な無料オプションはGoogleのGemini API 無料ティア(クレジットカード不要、期限切れなし)です。
無料のGeminiキーを取得する:
aistudio.google.comにアクセスし、Googleアカウントでサインインします。
Get API key → Create API key。コピーします。
GitHub Actionsワークフローを追加する:
あなたのvaultリポジトリで、
.github/workflows/graphify.ymlを作成し、このプロジェクトのvault-workflow/.github/workflows/graphify.ymlの内容を記述します。リポジトリ → Settings → Secrets and variables → Actions → New repository secret:
Name:
GEMINI_API_KEYValue: AI Studioのキー
リポジトリ → Settings → Actions → General → Workflow permissions → Read and write permissions に設定(ワークフローがグラフをコミットして戻せるようにするため)。
1日に1回自動的に実行され、vaultに変更をプッシュするたびにも実行されます。リポジトリの Actions タブから手動でトリガーすることもできます。
これにより、vaultリポジトリ内に graphify-out/graph.json と graphify-out/GRAPH_REPORT.md が生成されます — サーバー、Space、実行し続けるものは一切不要です。
MCPサーバーにはすでにそのためのツールがあります(graph_overview、graph_find_node、graph_neighbors) — read_note と同じようにGitHubから直接グラフを読み取ります。デプロイするものは追加で何もありません; 更新された server.js をRenderに再デプロイするだけで、次回Claudeが接続するときに表示されます。
ローカルテスト(オプション、デプロイ前)
npm install
GITHUB_TOKEN=xxx GITHUB_OWNER=you GITHUB_REPO=obsidian-vault npm startその後、MCPクライアントを使用して http://localhost:3000/mcp にPOSTするか、Renderに直接デプロイしてClaude経由でテストします。
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…
Notes and actions in one app. Let Claude or ChatGPT read and update them.
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
Persistent context for Claude. Your AI always knows your projects and next actions across sessions.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables Claude to read, write, search, and manage Obsidian vault notes with Git-backed sync support for multi-device access and extensible AI workflows.3,187 npm-
- AlicenseNot gradedqualityDmaintenanceConnects Claude Desktop to your Obsidian vault, enabling reading, writing, searching, and organizing notes locally.1MIT
- AlicenseAqualityDmaintenanceGives Claude direct access to an Obsidian vault, enabling read, write, search, and automatic git sync for cross-device use.163,187 npmApache 2.0
- AlicenseAqualityDmaintenanceConnects Claude Desktop to an Obsidian vault, enabling reading, searching, capturing ideas, and managing notes through natural language.216 npmMIT