MCP server for Obsidian (TypeScript + Bun)
@fazer-ai
关于 MCP server for Obsidian (TypeScript + Bun)
MCP server for Obsidian (TypeScript + Bun)
基本信息
配置
使用下面的配置,将此服务器添加到你的 MCP 客户端。
{
"mcpServers": {
"mcp-obsidian-fazer-ai": {
"command": "npx",
"args": [
"@modelcontextprotocol/inspector",
"bun",
"/path/to/repo/src/index.ts"
]
}
}
}工具
24Returns 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
FAQ from MCP server for Obsidian (TypeScript + Bun)
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.
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.
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).
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.
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.
记忆与知识 分类下的更多 MCP 服务器
Notion MCP Server
suekouA Model Context Protocol server for connecting Notion to MCP-compatible clients
Memory
modelcontextprotocolModel Context Protocol Servers
📓 GistPad MCP
lostintangent📓 An MCP server for managing your personal knowledge, daily notes, and re-usable prompts via GitHub Gists
Rust Docs MCP Server
Govcraft🦀 Prevents outdated Rust code suggestions from AI assistants. This MCP server fetches current crate docs, uses embeddings/LLMs, and provides accurate context via a tool call.
Ultimate Google Docs & Drive MCP Server
a-bonusThe Ultimate Google Docs, Sheets, Drive, Gmail, & Google Calendar MCP Server. This MCP (primarily for use in Claude Desktop) gains full access to your google suite and lets claude do its thing.
评论