Frequently Asked Questions about Obsidian GitHub MCP

Q: What is Obsidian GitHub MCP?

A: Obsidian GitHub MCP is a Model Context Protocol (MCP) server that allows AI assistants to access and interact with your Obsidian vault stored in a GitHub repository. It enables features like knowledge base access, intelligent search, and project management integration.

Q: Why would I use Obsidian GitHub MCP?

A: If you store your Obsidian vault in GitHub for backup, versioning, or collaboration, this tool allows you to leverage AI to analyze, search, and retrieve information from your notes more efficiently. It’s useful for research, writing, development, and learning.

Q: Which AI assistants are compatible with Obsidian GitHub MCP?

A: Obsidian GitHub MCP is compatible with any Model Context Protocol hosts like Claude, Cursor, Windsurf, and Cline.

Q: How do I install Obsidian GitHub MCP?

A: The recommended installation method is using Smithery. Alternatively, you can install it manually using npm install obsidian-github-mcp.

Q: What environment variables do I need to configure?

A: You need to set GITHUB_TOKEN (your GitHub personal access token), GITHUB_OWNER (your GitHub username or organization), and GITHUB_REPO (the name of your Obsidian vault repository).

Q: What GitHub token permissions are required?

A: Your GitHub token needs the repo (for private repositories) or public_repo (for public repositories) and read:org (if accessing organization repositories) permissions.

Q: I can’t find my file when searching by name. What should I do?

A: Use the searchIn: "filename" parameter in your search query to specifically search for files by their exact names.

Q: Can I search for content within specific folders in my Obsidian vault?

A: Yes, you can use the path: parameter in your search query to specify the directory you want to search within (e.g., path:"Daily Notes/").

Q: How can I track the evolution of my knowledge base using commit history?

A: Use the getCommitHistory tool, specifying the number of days and whether to include diffs in the results.

Q: Is Obsidian GitHub MCP related to UBOS?

A: Obsidian GitHub MCP can be used on the UBOS platform. UBOS is a Full-stack AI Agent Development Platform that helps you orchestrate AI Agents, connect them with your enterprise data, build custom AI Agents with your LLM model, and Multi-Agent Systems.