MCP server for Obsidian
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OBSIDIAN_API_KEY | Yes | Your API key for the Obsidian REST API. This key can be found in the Obsidian plugin config. |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_files_in_dir | Lists all files and directories that exist in a specific Obsidian directory. |
| list_files_in_vault | Lists all files and directories in the root directory of your Obsidian vault. |
| get_file_contents | Return the content of a single file in your vault. |
| simple_search | Simple search for documents matching a specified text query across all files in the vault. Use this tool when you want to do a simple text search |
| patch_content | Insert content into an existing note relative to a heading, block reference, or frontmatter field. |
| append_content | Append content to a new or existing file in the vault. |
| complex_search | Complex search for documents using a JsonLogic query. Supports standard JsonLogic operators plus 'glob' and 'regexp' for pattern matching. Results must be non-falsy. Use this tool when you want to do a complex search, e.g. for all documents with certain tags etc. |