Skip to main content
Glama
rileygramlich

obsidian-gate

Obsidian Gate

あなたのObsidianボールトをあらゆるAIエージェントに開放するMCPサーバー。

npx obsidian-gate init     # point at your vault
npx obsidian-gate          # dashboard on :3100

npm License: MIT


あなたのObsidianボールトはセカンドブレインです。あなたのAIエージェントがそれを利用できるようにすべきです。

Claude Code、Codex、Cursor — 設定は1行。あなたのボールトはエージェントがアクセス可能なワークスペースになります。あらゆるノート、あらゆるリンク、あらゆるタグ。すべてローカル、すべてあなたのもの、クラウド不要です。


試す

# One command to set up
npx obsidian-gate init

# Start the dashboard
npx obsidian-gate
# → http://localhost:3100/dashboard

これだけです。あなたのエージェントはボールトの読み取り、検索、書き込みができるようになります。


Related MCP server: obsidian-autom8

クイックスタート

1. ボールトを指定する

npx obsidian-gate init

ボールトのパスを求められます。貼り付けると、APIキーが返ってきます。

2. エージェントを接続する

Claude Code — これをMCP設定に貼り付けてください:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["obsidian-gate", "--mcp"]
    }
  }
}

任意のMCPクライアント(HTTP経由):

{
  "mcpServers": {
    "obsidian": {
      "type": "http",
      "url": "http://localhost:3100/mcp",
      "headers": { "Authorization": "Bearer sk-your-key" }
    }
  }
}

3. エージェントに依頼する

以下をお試しください:

プロンプト

動作

「昨日は何に取り組んだ?」

エージェントがデイリーノートを読み取ります

「ボールトからKubernetesのメモを検索して」

すべてのノートを全文検索します

「このデバッグセッションをボールトに保存して」

フロントマター付きの新しいノートを作成します

「会議メモをプロジェクトノートにリンクして」

[[wikilink]] を追加します


ツール — 9つの操作

ツール

説明

list_notes(path?)

ボールトフォルダ内のノートとフォルダを一覧表示

read_note(path)

ノートの全コンテンツ + パース済みフロントマター

search_notes(query, limit?)

ランク付けされた結果とスニペット付きの全文検索

create_note(path, content, frontmatter?)

ボールトテンプレートのフロントマター付きの新規ノート

update_note(path, content, mode?)

ノートを上書きまたは追記

get_backlinks(path)

[[wikilink]] でここにリンクしているすべてのノート

get_tags()

すべてのタグ(フロントマターとインライン)を件数付き

get_daily_note(date?)

デイリーノートを取得または作成(今日、昨日、-1、ISO)

create_link(from, to, label?)

## Related の下に [[wikilink]] を追加

ノートはMCPリソースとしても公開されます:obsidian://{vault}/{path}。


CLI

コマンド

説明

init

対話型セットアップウィザード

serve(デフォルト)

ダッシュボード + MCP HTTP(:3100)

--mcp

stdio経由でMCPサーバーとして実行

doctor

ボールトへのアクセスと9つのツールすべてを検証

keys list

エージェント接続を表示

keys new <name>

新しいAPIキーを作成

keys rotate <id>

キーをローテーション

keys revoke <id>

キーを失効

vault list

設定済みボールト

vault add <name> <path>

ボールトを追加

vault remove <name>

ボールトを削除

license status

プランと利用状況

license set <key>

ライセンスキーを有効化

activity

エージェントのアクティビティログ


料金

ティア

料金

内容

無料

$0

月50クエリ、ボールト1つ、エージェント1つ

パーソナル

$19/月

無制限クエリ、ボールト3つ、無制限エージェント

チーム

$49/月

パーソナルの全機能 + 共有設定、優先サポート

有料プランは14日間の無料トライアル。リスクはありません。いつでもキャンセルできます。


アーキテクチャ

┌────────────┐     ┌──────────────────────┐     ┌──────────────┐
│ AI Agent   │────▶│   obsidian-gate      │────▶│  Obsidian    │
│ (Claude,   │◀────│   (MCP Server)       │◀────│  Vault       │
│  Codex,    │     │                      │     │  (files)     │
│  Cursor)   │     │  stdio ─ dashboard   │     └──────────────┘
└────────────┘     └──────────────────────┘
  • すべてローカル。 すべてのバイトがお使いのマシン上にあります。クラウドも、サーバーも、同期もありません。

  • 設定ファイル: ~/.obsidian-gate/config.json(モード0600)

  • APIキーはローカルシークレットです。スタックはすべてお客様のものです。

  • アクティビティログは、すべてのエージェント操作をJSONLで記録します。


Gateがやらないこと

  • ❌ Obsidianプラグインではありません(ただし、コミュニティプラグインは計画中)

  • ❌ 同期エンジンではありません(ボールトディレクトリを直接読み書きします)

  • ❌ ノートエディタではありません(Obsidianの方が得意です)

  • ❌ クラウドサービスではありません(完全にあなたのマシン上で動作します)

1つの小さなことをうまくやります:あなたのボールトのためのMCPサーバーです。


ロードマップ

  • 9つのツールを備えたMCPサーバー

  • ローカルダッシュボード + アクティビティログ

  • APIキー認証 + 権限

  • Stripeライセンス(無料 + 有料ティア)

  • Obsidianコミュニティプラグイン(ワンクリックインストール)

  • LLMフロントマターによるエージェントの書き戻し

  • ボールトコンテンツからの自動タグ付け

  • デイリーダイジェスト:ボールトの変更点


開発

git clone https://github.com/rileygramlich/obsidian-gate.git
cd obsidian-gate
npm install
npm run build     # compile TypeScript → dist/
npm run dev       # hot-reload with tsx

Riley G. が制作 — Marc Louのプレイブックに着想を得ています:速く届ける、無料ティア、広告費ゼロ、パブリックビルド。

MIT — ビルドして、リリースして、販売してください。

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to remotely access and interact with Obsidian vaults via MCP, supporting note operations, tag management, graph queries, and command execution.
    4
    GPL 3.0
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables reading, writing, searching, and managing Obsidian vault notes through MCP tools and prompts, allowing AI agents to interact with local knowledge bases.
    -