0.0
No release in over a year
MCP servers focused on fetching and presenting information from Obsidian vaults
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Runtime

~> 0.14.0
>= 5.0
>= 2.0
 Project Readme

ObsidianFetch

Languages: 日本語

MCP servers focused on fetching and presenting information from Obsidian vaults.

The existing MCP server has the following drawbacks:

  • It supports many commands, which can cause slow prompt loading when computational resources are limited.
  • When reading a note labeled "Sample Note", it is necessary to search for its path first before loading it, but the LLM may not always follow this procedure.
  • Some tools include unnecessary options, leading the LLM to sometimes fail to invoke them correctly.

These issues become particularly noticeable when running an LLM on a local GPU.
To address this, we developed a new MCP server that simply retrieves and loads lists of notes.

The new server also provides the following additional features:

  • When the LLM attempts to retrieve link information by searching with brackets like [[link name]], the server automatically removes any characters that cannot be used in links.
  • In addition to loading the note contents, it also displays backlinks—notes that link to the currently opened note.
    • This allows the LLM to load and understand the connections between related notes via backlinks.

Installation

gem install obsidian_fetch

Usage

Stdio Transport (default)

obsidian_fetch /path/to/your/vault

Streamable HTTP Transport

To run the server as an HTTP server:

obsidian_fetch /path/to/your/vault --transport streamable-http

By default, the server listens on http://localhost:9292. You can customize the port:

obsidian_fetch /path/to/your/vault --transport streamable-http --port 3000

Tools

  • read: Read a note from the Obsidian vault. If multiple notes with the same name are found, all will be shown.
  • list: Search for files with matching names partially.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/soukouki/obsidian_fetch.

License

The gem is available as open source under the terms of the MIT License.