MCP.so
ログイン

MCP server for Obsidian (TypeScript + Bun)

@fazer-ai

基本情報

カテゴリ

メモリとナレッジ

ライセンス

MIT

トランスポート

stdio

作者

fazer-ai

MCP server for Obsidian について

MCP server for Obsidian (TypeScript + Bun)

MCP server for Obsidian の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "mcp-obsidian-fazer-ai": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "bun",
        "/path/to/repo/src/index.ts"
      ]
    }
  }
}

MCP server for Obsidian のツール

24

Returns basic details about the Obsidian Local REST API server and your authentication status

Deletes the note that is currently active in the Obsidian UI

Retrieves the full content of the active note (Markdown or JSON view)

Inserts, replaces or prepends content in the active note relative to a heading, block reference, or front-matter field

Appends Markdown to the end of the active note

Replaces the entire body of the active note

Lists every command available in Obsidian’s command palette

Executes a specific Obsidian command by its ID

Opens the given file inside Obsidian (creates it if missing); optional flag to open in a new leaf

Deletes the current daily / weekly / monthly / quarterly / yearly note for the requested period

Returns the content of the current periodic note for the requested period

Inserts / replaces content in a periodic note relative to a heading, block reference, or front-matter field

Appends Markdown to the periodic note (creates it if it doesn’t exist)

Replaces the entire body of a periodic note

Runs a Dataview-DQL query across the vault and returns matching rows

Runs a JsonLogic query against structured note metadata

Performs a plain-text fuzzy search with optional surrounding context

Lists all files and directories at the **root** of your vault

Lists files and directories inside a **specific folder** of the vault

Deletes a specific file (or directory) in the vault

Retrieves the content of a file in the vault (Markdown or JSON view)

Inserts / replaces content in an arbitrary file relative to a heading, block reference, or front-matter field

Appends Markdown to a file (creates it if it doesn’t exist)

Creates a new file or replaces the entire body of an existing file

概要

What is MCP server for Obsidian (TypeScript + Bun)?

An MCP server that lets Claude or any MCP-compatible LLM interact with your Obsidian vault through the Local REST API community plugin. It is written in TypeScript and runnable with bunx.

How to use MCP server for Obsidian (TypeScript + Bun)?

Install and run with bunx @fazer-ai/mcp-obsidian@latest. Configure the API key via the env field in your MCP client config (e.g., claude_desktop_config.json) or an .env file. The Obsidian Local REST API plugin must be installed and running.

Key features of MCP server for Obsidian (TypeScript + Bun)

  • 24 tools for reading, writing, and managing notes
  • Supports periodic notes (daily, weekly, monthly, etc.)
  • Executes Obsidian commands by their ID
  • Searches with fuzzy, Dataview-DQL, and JsonLogic queries
  • Opens, creates, and deletes files in the vault
  • Patches content relative to headings or block references

Use cases of MCP server for Obsidian (TypeScript + Bun)

  • Summarize meeting notes by reading the active note
  • Search across the vault for keywords like “Azure Cosmos Db”
  • Create a daily summary note and append to a period note
  • Open a specific file in Obsidian from a prompt
  • Delete outdated periodic notes automatically

よくある質問

1

How do I provide my Obsidian API key?

You can set the `OBSIDIAN_API_KEY` environment variable in your MCP client config (recommended) or place it in a `.env` file in the working directory.

2

What runtime does the server require?

It requires Bun to run. You can use `bunx` to execute the npm package directly, or run a local copy with `bun`.

3

How do I debug the server?

Use the MCP Inspector: run `npx @modelcontextprotocol/inspector bun /path/to/src/index.ts` and open the printed URL (usually http://localhost:6274).

4

How do I run a local development version?

Clone the repo, run `bun install`, and point Claude’s config to your local `src/index.ts` using `bun` instead of `bunx`.

5

Where does the API key come from?

It is obtained from the Local REST API plugin settings inside Obsidian. The server also uses configurable `OBSIDIAN_PROTOCOL`, `OBSIDIAN_HOST`, and `OBSIDIAN_PORT` (default 27123) environment variables.

コメント

「メモリとナレッジ」の他のコンテンツ