[{"_1":2,"_376":-5,"_377":-5},"loaderData",{"_3":4,"_31":32,"_246":247},"root",{"_5":6,"_14":15},"toasts",[7],{"_8":9,"_10":11,"_12":13},"uid","019a76f4-0553-73ed-97e6-9f523e01e88e","title","This MCP server does not support inspection","type","error","visitor",{"_16":17,"_18":19},"viewportWidth",1280,"visitorSession",{"_20":21,"_23":24,"_25":-5,"_26":27,"_28":29,"_30":-5},"attributes",[22],"bot","id",23446952,"membership","referenceId","019a5a4d-61d1-703c-9553-063a91322bdb","unreadReleaseNotesCount",1,"userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_33":34,"_35":-5,"_36":37,"_38":50,"_165":166,"_244":245},"availableLocales",[],"githubUser","locale",{"_38":39,"_46":47,"_48":49},"mcpServer",{"_40":41,"_42":43,"_44":45},"description","A Model Context Protocol server that provides tools for searching private GitHub repositories, enabling access to repository files, commit history, and issues with automatic handling of rate limiting and error handling.","displayName","MCP Private GitHub Search","readme","[![smithery badge](https://smithery.ai/badge/@Hint-Services/obsidian-github-mcp)](https://smithery.ai/server/@Hint-Services/obsidian-github-mcp)\n[![npm version](https://img.shields.io/npm/v/obsidian-github-mcp)](https://www.npmjs.com/package/obsidian-github-mcp)\n\n# Obsidian GitHub MCP\n\nA Model Context Protocol (MCP) server that connects AI assistants to GitHub repositories containing Obsidian vaults. This server enables seamless integration with your knowledge base stored on GitHub, allowing AI assistants to read, search, and analyze your Obsidian notes and documentation.\n\n## Why This Tool?\n\nMany Obsidian users store their vaults in GitHub for backup, versioning, and collaboration. This MCP server bridges the gap between your GitHub-hosted Obsidian vault and AI assistants, enabling:\n\n- **Knowledge Base Access**: Retrieve specific notes and documents from your Obsidian vault\n- **Intelligent Search**: Find relevant content across your entire knowledge base\n- **Evolution Tracking**: See how your ideas and notes have developed over time\n- **Task Integration**: Connect with issues and project management workflows\n\n## Features\n\n- **GitHub Repository Access**: Connect to any GitHub repository containing your Obsidian vault\n- **Type-Safe Implementation**: Written in TypeScript with comprehensive type definitions\n- **Input Validation**: Robust validation for all API inputs using Zod schemas\n- **Error Handling**: Graceful error handling with informative messages\n- **MCP Integration**: Full compatibility with Claude, Cursor, Windsurf, Cline, and other MCP hosts\n\n## Available Tools\n\n### Knowledge Base Access\n\n- **getFileContents**: Retrieve the contents of specific notes, documents, or files from your Obsidian vault\n- **searchFiles**: Enhanced search with multiple modes:\n - `filename`: Find files by exact filename (perfect for \"OKR 2025\" type searches)\n - `path`: Search anywhere in file paths \n - `content`: Search within file contents\n - `all`: Comprehensive search across filenames, paths, and content\n\n### Project Management Integration\n\n- **searchIssues**: Search for issues and discussions related to your knowledge base projects\n- **getCommitHistory**: Track how your knowledge base has evolved over time with detailed commit history and diffs\n\n## Use Cases\n\n### For Knowledge Workers\n- **Research Assistant**: AI can access your research notes and reference materials\n- **Writing Support**: Pull relevant background information from your knowledge base\n- **Idea Development**: Track how concepts have evolved across your notes\n\n### For Developers\n- **Documentation Access**: Retrieve project documentation and technical notes\n- **Learning Journals**: Access your learning notes and code examples\n- **Project Planning**: Integrate with GitHub issues for comprehensive project management\n\n### For Students & Academics\n- **Study Materials**: Access lecture notes and study guides\n- **Research Papers**: Retrieve research notes and citations\n- **Collaboration**: Work with shared knowledge bases stored in GitHub\n\n## Installation\n\n### Using Smithery (Recommended)\n\nThe easiest way to install Obsidian GitHub MCP is using Smithery:\n\n```bash\n# For Claude Desktop\nnpx -y @smithery/cli install @Hint-Services/obsidian-github-mcp --client claude\n\n# For Cursor\nnpx -y @smithery/cli install @Hint-Services/obsidian-github-mcp --client cursor\n\n# For Windsurf\nnpx -y @smithery/cli install @Hint-Services/obsidian-github-mcp --client windsurf\n\n# For Cline\nnpx -y @smithery/cli install @Hint-Services/obsidian-github-mcp --client cline\n```\n\n### Manual Installation\n\n```bash\nnpm install obsidian-github-mcp\n```\n\n## Configuration\n\nAdd the server to your MCP settings file with the following configuration:\n\n```json\n{\n \"mcpServers\": {\n \"obsidianGithub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"obsidian-github-mcp\"],\n \"env\": {\n \"GITHUB_TOKEN\": \"your-github-token\",\n \"GITHUB_OWNER\": \"your-github-username\",\n \"GITHUB_REPO\": \"your-obsidian-vault-repo\"\n }\n }\n }\n}\n```\n\n### Required Environment Variables\n\n- `GITHUB_TOKEN`: Your GitHub personal access token ([create one here](https://github.com/settings/tokens))\n- `GITHUB_OWNER`: The owner/organization of the GitHub repository\n- `GITHUB_REPO`: The name of the repository containing your Obsidian vault\n\n### GitHub Token Permissions\n\nYour GitHub token needs the following permissions:\n- `repo` (for private repositories) or `public_repo` (for public repositories)\n- `read:org` (if accessing organization repositories)\n\n## Example Workflows\n\n### Accessing Your Daily Notes\n\n```json\n{\n \"tool\": \"getFileContents\",\n \"arguments\": {\n \"filePath\": \"Daily Notes/2024-01-15.md\"\n }\n}\n```\n\n### Finding Files by Name (Perfect for \"OKR 2025\" example!)\n\n```json\n{\n \"tool\": \"searchFiles\",\n \"arguments\": {\n \"query\": \"OKR 2025\",\n \"searchIn\": \"filename\"\n }\n}\n```\n\n### Finding Files by Path\n\n```json\n{\n \"tool\": \"searchFiles\",\n \"arguments\": {\n \"query\": \"Daily Notes\",\n \"searchIn\": \"path\"\n }\n}\n```\n\n### Finding Research on a Topic (Content Search)\n\n```json\n{\n \"tool\": \"searchFiles\",\n \"arguments\": {\n \"query\": \"machine learning algorithms\",\n \"searchIn\": \"content\",\n \"perPage\": 10\n }\n}\n```\n\n### Comprehensive Search (Filename, Path, and Content)\n\n```json\n{\n \"tool\": \"searchFiles\",\n \"arguments\": {\n \"query\": \"project planning\",\n \"searchIn\": \"all\"\n }\n}\n```\n\n### Advanced GitHub Search Syntax\n\n```json\n{\n \"tool\": \"searchFiles\",\n \"arguments\": {\n \"query\": \"path:*.md extension:md\",\n \"searchIn\": \"content\"\n }\n}\n```\n\n### Tracking Knowledge Evolution\n\n```json\n{\n \"tool\": \"getCommitHistory\",\n \"arguments\": {\n \"days\": 30,\n \"includeDiffs\": true,\n \"maxCommits\": 10\n }\n}\n```\n\n## Search Tips & Troubleshooting\n\n### Can't Find Your File by Name?\n\n**Problem**: Searching for \"OKR 2025\" doesn't find your file named \"OKR 2025.md\"\n\n**Solution**: Use the `searchIn: \"filename\"` parameter:\n\n```json\n{\n \"tool\": \"searchFiles\",\n \"arguments\": {\n \"query\": \"OKR 2025\",\n \"searchIn\": \"filename\"\n }\n}\n```\n\n### Advanced Search Techniques\n\n1. **Exact Phrases**: Use quotes for multi-word searches\n ```json\n {\n \"query\": \"\\\"project planning 2025\\\"\",\n \"searchIn\": \"content\"\n }\n ```\n\n2. **File Extensions**: Find specific file types\n ```json\n {\n \"query\": \"path:*.md\",\n \"searchIn\": \"content\"\n }\n ```\n\n3. **Directory Specific**: Search within folders\n ```json\n {\n \"query\": \"path:\\\"Daily Notes/\\\"\",\n \"searchIn\": \"content\"\n }\n ```\n\n## Project Structure\n\n```\nobsidian-github-mcp/\n├── src/\n│ ├── index.ts # Main MCP server entry point\n│ └── github/ # GitHub API integration\n│ ├── client.ts # GitHub client implementation\n│ └── types.ts # TypeScript type definitions\n├── docs/ # Documentation\n├── package.json # Project configuration\n└── tsconfig.json # TypeScript configuration\n```\n\n## For Developers\n\nIf you're interested in contributing to this project or developing your own tools with this server, please see the [Development Guide](docs/development.md).\n\n### Development Commands\n\n- `pnpm install` - Install dependencies\n- `pnpm run build` - Build the project\n- `pnpm run dev` - Run in development mode with inspector\n- `pnpm run inspector` - Launch MCP inspector for testing\n\n## Migration from mcp-private-github-search\n\nIf you're migrating from the older `mcp-private-github-search` package:\n\n1. Update your package name in configuration:\n ```json\n {\n \"mcpServers\": {\n \"obsidianGithub\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"obsidian-github-mcp\"]\n }\n }\n }\n ```\n\n2. The functionality remains the same - all existing tools work identically\n3. Consider the new Obsidian-focused use cases and workflows\n\n## Learn More\n\nFor further information on the MCP ecosystem, refer to:\n\n- [Model Context Protocol Documentation](https://modelcontextprotocol.io): Detailed coverage of MCP architecture and design principles\n- [Smithery - MCP Server Registry](https://smithery.ai/docs): Guidelines for publishing MCP servers\n- [MCP TypeScript SDK Documentation](https://modelcontextprotocol.io/typescript): Comprehensive TypeScript SDK documentation\n- [Obsidian](https://obsidian.md): The knowledge management app that inspired this tool\n\n## About Hint Services\n\n> \"The future is already here, it's just unevenly distributed\"\n>\n> — William Gibson, Author\n\nHint Services is a boutique consultancy with a mission to develop and expand how user interfaces leverage artificial intelligence technology. We architect ambition at the intersection of AI and User Experience, founded and led by Ben Hofferber.\n\nWe offer specialized AI workshops for design teams looking to embrace AI tools without becoming developers. [Learn more about our training and workshops](https://hint.services/training-workshops).","name","English","tag","en-US",{"_51":52,"_20":53,"_61":41,"_62":41,"_42":43,"_23":63,"_64":65,"_90":91,"_98":-5,"_99":100,"_101":102,"_152":153,"_158":-5,"_72":159,"_160":161,"_8":162,"_163":164},"addedAt","2025-05-29T03:06:45.002012Z",[54,55,56,57,58,59,60],"category:version-control","category:databases","environment:network","hosting:remote-capable","language:typescript","security_grade:a","quality_grade:a","descriptionMarkdown","descriptionPlainText",7227,"integrations",[66,76,83],{"_67":68,"_40":74,"_8":75},"brand",{"_69":70,"_46":71,"_72":73},"logoSvgPath","M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12","GitHub","slug","github","Enables searching private GitHub repositories, retrieving file contents, accessing commit history with optional diffs, and searching issues based on various criteria.","of7ufvrnex",{"_67":77,"_40":81,"_8":82},{"_69":78,"_46":79,"_72":80},"M1.125 0C.502 0 0 .502 0 1.125v21.75C0 23.498.502 24 1.125 24h21.75c.623 0 1.125-.502 1.125-1.125V1.125C24 .502 23.498 0 22.875 0zm17.363 9.75c.612 0 1.154.037 1.627.111a6.38 6.38 0 0 1 1.306.34v2.458a3.95 3.95 0 0 0-.643-.361 5.093 5.093 0 0 0-.717-.26 5.453 5.453 0 0 0-1.426-.2c-.3 0-.573.028-.819.086a2.1 2.1 0 0 0-.623.242c-.17.104-.3.229-.393.374a.888.888 0 0 0-.14.49c0 .196.053.373.156.529.104.156.252.304.443.444s.423.276.696.41c.273.135.582.274.926.416.47.197.892.407 1.266.628.374.222.695.473.963.753.268.279.472.598.614.957.142.359.214.776.214 1.253 0 .657-.125 1.21-.373 1.656a3.033 3.033 0 0 1-1.012 1.085 4.38 4.38 0 0 1-1.487.596c-.566.12-1.163.18-1.79.18a9.916 9.916 0 0 1-1.84-.164 5.544 5.544 0 0 1-1.512-.493v-2.63a5.033 5.033 0 0 0 3.237 1.2c.333 0 .624-.03.872-.09.249-.06.456-.144.623-.25.166-.108.29-.234.373-.38a1.023 1.023 0 0 0-.074-1.089 2.12 2.12 0 0 0-.537-.5 5.597 5.597 0 0 0-.807-.444 27.72 27.72 0 0 0-1.007-.436c-.918-.383-1.602-.852-2.053-1.405-.45-.553-.676-1.222-.676-2.005 0-.614.123-1.141.369-1.582.246-.441.58-.804 1.004-1.089a4.494 4.494 0 0 1 1.47-.629 7.536 7.536 0 0 1 1.77-.201zm-15.113.188h9.563v2.166H9.506v9.646H6.789v-9.646H3.375z","TypeScript","typescript","Implements type-safe interactions with GitHub APIs through comprehensive TypeScript type definitions.","jp8wgmqzfz",{"_67":84,"_40":88,"_8":89},{"_69":85,"_46":86,"_72":87},"M19.088 2.477 24 7.606 12.521 20.485l-.925 1.038L0 7.559l5.108-5.082h13.98Zm-17.434 5.2 6.934-4.003H5.601L1.619 7.636l.035.041Zm12.117-4.003L3.333 9.7l2.149 2.588 10.809-6.241-.2-.346 2.851-1.646-.365-.381h-4.806Zm7.52 2.834L8.257 14.034h5.101v-.4h3.667l5.346-5.998-1.08-1.128Zm-7.129 10.338H9.268l2.36 2.843 2.534-2.843Z","Zod","zod","Utilizes Zod schemas for robust input validation of all API inputs to ensure data integrity when interacting with GitHub resources.","tig4j71zik","namespace",{"_92":93,"_72":97},"owner",{"_94":95},"githubAccount",{"_96":97},"login","Hint-Services","readmeMarkdown","redditPostExternalId","1nybyxa","repository",{"_103":104,"_120":121,"_124":125,"_144":-5,"_145":146,"_147":148,"_151":-5},"argumentsJsonSchema",{"_105":106,"_117":118,"_12":119},"properties",{"_107":108,"_111":112,"_114":115},"GITHUB_REPO",{"_40":109,"_12":110},"The name of the repository containing your Obsidian vault","string","GITHUB_OWNER",{"_40":113,"_12":110},"The owner/organization of the GitHub repository","GITHUB_TOKEN",{"_40":116,"_12":110},"Your GitHub personal access token (create one here: https://github.com/settings/tokens)","required",[114,111,107],"object","githubProject",{"_44":45,"_122":123},"url","https://github.com/hint-services/mcp-private-github-search","githubRepository",{"_126":127,"_128":129,"_130":131,"_23":132,"_133":79,"_46":134,"_92":135,"_137":138,"_139":140,"_142":143},"defaultBranch","main","fullName","Hint-Services/obsidian-github-mcp","githubTreeId",2596453,14792,"language","obsidian-github-mcp",{"_96":97,"_8":136},"qbbaqpvs7n","recentStargazers",0,"spdxLicense",{"_46":141},"MIT License","stargazers",7,"glamaJson","inspectable",true,"npmPackage",{"_46":134,"_149":150},"weeklyDownloads",3,"supportedPlatforms","scores",{"_154":-5,"_155":156,"_157":156},"license","quality",100,"security","simpleIcon","mcp-private-github-search","toolCount",4,"drc94l73l1","updatedAt","2025-10-01T13:34:24.945816Z","meta",[167,169,171,178,181,183,186,189,192,195,198,200,203,206,208,210,212,214,216],{"_10":168},"MCP Private GitHub Search | Glama",{"_170":41,"_46":40},"content",{"_172":173,"_174":175,"_176":177},"href","https://glama.ai/mcp/servers/@Hint-Services/mcp-private-github-search","rel","canonical","tagName","link",{"_170":43,"_179":180},"property","og:title",{"_170":41,"_179":182},"og:description",{"_170":184,"_179":185},"https://glama.ai/logo.png","og:logo",{"_170":187,"_179":188},"https://glama.ai/mcp/servers/@Hint-Services/mcp-private-github-search/og-image","og:image",{"_170":190,"_179":191},"630","og:image:height",{"_170":193,"_179":194},"1200","og:image:width",{"_170":196,"_179":197},"website","og:type",{"_170":173,"_179":199},"og:url",{"_170":201,"_179":202},"Glama – MCP Hosting Platform","og:site_name",{"_170":204,"_46":205},"summary_large_image","twitter:card",{"_170":201,"_46":207},"twitter:title",{"_170":41,"_46":209},"twitter:description",{"_170":187,"_46":211},"twitter:image",{"_170":190,"_46":213},"twitter:image:height",{"_170":193,"_46":215},"twitter:image:width",{"_217":218},"script:ld+json",{"_219":220,"_221":222},"@context","http://schema.org","@graph",[223],{"_219":224,"_225":226,"_227":228},"https://schema.org","@type","BreadcrumbList","itemListElement",[229,235,239,242],{"_225":230,"_231":232,"_46":233,"_234":29},"ListItem","item","/","Glama","position",{"_225":230,"_231":236,"_46":237,"_234":238},"/mcp","MCP",2,{"_225":230,"_231":240,"_46":241,"_234":150},"/mcp/servers","Servers",{"_225":230,"_231":243,"_46":43,"_234":161},"/mcp/servers/@Hint-Services/mcp-private-github-search","visitorIsMaintainer",false,"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_248":249,"_38":255,"_280":281,"_165":292,"_290":316,"_317":318},"blob",{"_170":250,"_251":252,"_253":254},"\n","fileName","icon.svg","size",1742,{"_51":52,"_20":256,"_61":41,"_62":41,"_42":43,"_23":63,"_64":257,"_90":264,"_98":-5,"_99":100,"_101":267,"_152":279,"_158":-5,"_72":159,"_160":161,"_8":162,"_163":164},[54,55,56,57,58,59,60],[258,260,262],{"_67":259,"_40":74,"_8":75},{"_69":70,"_46":71,"_72":73},{"_67":261,"_40":81,"_8":82},{"_69":78,"_46":79,"_72":80},{"_67":263,"_40":88,"_8":89},{"_69":85,"_46":86,"_72":87},{"_92":265,"_72":97},{"_94":266},{"_96":97},{"_103":268,"_120":274,"_124":275,"_144":-5,"_145":146,"_147":278,"_151":-5},{"_105":269,"_117":273,"_12":119},{"_107":270,"_111":271,"_114":272},{"_40":109,"_12":110},{"_40":113,"_12":110},{"_40":116,"_12":110},[114,111,107],{"_44":45,"_122":123},{"_126":127,"_128":129,"_130":131,"_23":132,"_133":79,"_46":134,"_92":276,"_137":138,"_139":277,"_142":143},{"_96":97,"_8":136},{"_46":141},{"_46":134,"_149":150},{"_154":-5,"_155":156,"_157":156},"member",{"_282":283,"_286":287,"_288":252,"_130":131,"_289":245,"_290":252,"_291":146,"_253":254,"_12":248},"commit",{"_284":285},"sha","f5397b65b825bb016ba5491df219180fab0175bc","contentStoredObjectPointerId",18943863,"fullPath","indexable","path","safeToDisplayAsText",[293,295,297,299,301,302,303,305,306,307,308,309,310,311,312,313,314,315],{"_10":294},"icon.svg | MCP Private GitHub Search | Glama",{"_170":296,"_46":40},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_172":298,"_174":175,"_176":177},"https://glama.ai/mcp/servers/@Hint-Services/mcp-private-github-search/blob/f5397b65b825bb016ba5491df219180fab0175bc/",{"_170":300,"_179":180},"icon.svg | MCP Private GitHub Search",{"_170":296,"_179":182},{"_170":184,"_179":185},{"_170":304,"_179":188},"https://glama.ai/generated-images/og?title=icon.svg+%7C+MCP+Private+GitHub+Search",{"_170":190,"_179":191},{"_170":193,"_179":194},{"_170":196,"_179":197},{"_170":298,"_179":199},{"_170":201,"_179":202},{"_170":204,"_46":205},{"_170":201,"_46":207},{"_170":296,"_46":209},{"_170":304,"_46":211},{"_170":190,"_46":213},{"_170":193,"_46":215},"","treeMembers",[319,323,326,329,332,335,338,341,344,347,350,352,355,358,361,364,367,370,373],{"_282":320,"_288":321,"_290":321,"_12":322},{"_284":285},".claude","tree",{"_282":324,"_288":325,"_290":325,"_12":322},{"_284":285},".cursor",{"_282":327,"_288":328,"_290":328,"_12":322},{"_284":285},"docs",{"_282":330,"_288":331,"_290":331,"_12":322},{"_284":285},"src",{"_282":333,"_288":334,"_290":334,"_12":322},{"_284":285},"tests",{"_282":336,"_288":337,"_290":337,"_12":248},{"_284":285},"biome.json",{"_282":339,"_288":340,"_290":340,"_12":248},{"_284":285},"CHANGELOG.md",{"_282":342,"_288":343,"_290":343,"_12":248},{"_284":285},"CLAUDE.md",{"_282":345,"_288":346,"_290":346,"_12":248},{"_284":285},".gitattributes",{"_282":348,"_288":349,"_290":349,"_12":248},{"_284":285},".gitignore",{"_282":351,"_288":252,"_290":252,"_12":248},{"_284":285},{"_282":353,"_288":354,"_290":354,"_12":248},{"_284":285},"LICENSE",{"_282":356,"_288":357,"_290":357,"_12":248},{"_284":285},"MIGRATION_GUIDE.md",{"_282":359,"_288":360,"_290":360,"_12":248},{"_284":285},"package.json",{"_282":362,"_288":363,"_290":363,"_12":248},{"_284":285},"pnpm-lock.yaml",{"_282":365,"_288":366,"_290":366,"_12":248},{"_284":285},"pnpm-workspace.yaml",{"_282":368,"_288":369,"_290":369,"_12":248},{"_284":285},"README.md",{"_282":371,"_288":372,"_290":372,"_12":248},{"_284":285},"smithery.yaml",{"_282":374,"_288":375,"_290":375,"_12":248},{"_284":285},"tsconfig.json","actionData","errors"]

MCP directory API