obsidian-get

The obsidian-get tool is a specialized utility designed for agentic workflows to retrieve raw markdown content from an Obsidian vault. It serves as a critical data-access layer in a Personal Knowledge Management (PKM) ecosystem, allowing agents to ingest, analyze, and synthesize information stored in local markdown notes. By providing a direct mechanism to read specific files, this tool enables complex reasoning tasks, such as cross-referencing research documents, extracting project requirements, or summarizing long-form notes that have been previously identified through discovery tools like obsidian-search. It is specifically optimized for agents acting within a local development or knowledge-worker environment where local file system access is constrained by security policies.

• Retrieves the complete markdown source code of any accessible note within the configured Obsidian vault.

• Supports relative file path resolution to ensure strict adherence to vault boundaries, preventing unauthorized access outside the intended directory.

• Includes configurable truncation thresholds to manage context window limits when processing exceptionally large markdown documents.

• Seamlessly integrates with the CyberneticAgents runtime, allowing for sequential tool chaining where an agent searches for a note and subsequently reads its content for further processing.

• Use this tool after performing an obsidian-search to retrieve the full context of a relevant file.

• Ensure that the OBSIDIAN_VAULT_PATH is correctly configured in the environment variables to allow the tool to locate your files.

• The tool expects a relative path string as input (e.g., Projects/Research/Draft.md).

• Be mindful of character limits; if a note is extremely long, the output may be truncated to protect system stability and token efficiency.

• This tool is designed for read-only access to markdown files; ensure your Obsidian vault is accessible to the agent runtime via the containerized environment.