Claudesidian MCP
About
Integrates Model Context Protocol (MCP) with Obsidian, allowing AI assistants to interact with your notes and vault.
Details
- Author
- profsynapse
- Categories
- Productivity, Other, Knowledge Base
Jump to
Setup
Install Claudesidian MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/profsynapse/claudesidian-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
Nexus gives AI agents and built-in chat access to your Obsidian vault so you can read, write, search, organize, and automate notes in natural language while keeping storage local to the vault.
- Inside Obsidian with native chat (hook up to your favorite provider or agentic platform!)
- From external agents like Claude Desktop, Claude Code, Codex CLI, Gemini CLI, Cursor, Cline, and other MCP clients
Nexus is the successor to Claudesidian. Legacy installs in.obsidian/plugins/claudesidian-mcp/still work.
- Install the latest release fromGitHub Releases:manifest.json,styles.css, andmain.js
- Put them in.obsidian/plugins/nexus/and enableNexusin Obsidian
- Native chat in Obsidian:Provider setupandNative chat guidefor chat, live voice, read-aloud, and built-in audio/video generation
- External agent over MCP: useNexus settings -> Get started -> External agentsto createconnector.jsand update Claude Desktop, then seeMCP setup guideandRecommended system prompt
- External agent over CLI (no MCP config): install thenexuscommand fromGet started -> External agents -> Local CLIso shell agents (Claude Code, Cursor, Codex) can drive your vault directly — see theNexus CLI guide. Installation is user-triggered, writes only outside the vault, and on Windows adds the Nexus directory to the current user's PATH without administrator rights; uninstall removes only entries Nexus recorded as its own.
- Optional desktop features:Semantic search,Adaptive search, andApps and integrations
Native chat works on desktop and mobile. MCP clients, local desktop providers, and semantic search are desktop-only.
Native chat works on mobile (iOS and Android). Desktop-only features gracefully skip loading on mobile -- they will not appear or cause errors.
Mobile support is new and may have bugs. Pleasereport issues on GitHub.
Nexus does not call out on its own.Nothing is sent when the plugin loads, and there is no telemetry, analytics, crash reporting, or usage tracking of any kind. Your notes stay in your vault unless you do something that sends them somewhere. Every request below is listed with the action that causes it.
AI provider APIs.Contacted only once you enter that provider's API key and then use it. Your prompt — and whatever vault content the agent decides to include — goes to the provider you chose, and your key is only ever sent to the provider it belongs to.
Ollama and LM Studio talk to your own machine and leave it entirely.
Downloads for optional desktop features.A few features fetch their engine the first time you enable them, rather than shipping insidemain.js— the download is cached and does not repeat. Never enabling the feature means never making the request.
Housekeeping.Opening Nexus settings checks for a newer version (api.github.com,raw.githubusercontent.com). Asking an agent to load the built-in guides workspace fetches the current guides (raw.githubusercontent.com).
Not requests.Two things look like external hosts but aren't. Calls to OpenRouter and Requesty carryHTTP-Referer: https://synapticlabs.aiandX-Title: Nexus— the app-attribution headers those routers show in their dashboards. They are headervalues; nothing is fetched from that address. And buttons likeDownload Node.jsorGet an API keyopennodejs.org,ollama.com,lmstudio.ai,claude.ai,github.com, or the provider's own console (platform.openai.com,console.anthropic.com,aistudio.google.com, and so on)in your browser— the plugin never retrieves them.
If you want another agent to walk you through setup, paste this:
Help me set up Nexus for Obsidian and guide me step by step. Use these docs as the source of truth: - README: https://github.com/ProfSynapse/claudesidian-mcp/blob/main/README.md - Provider setup: https://github.com/ProfSynapse/claudesidian-mcp/blob/main/guide/provider-setup.md - MCP setup: https://github.com/ProfSynapse/claudesidian-mcp/blob/main/guide/mcp-setup.md - Recommended system prompt: https://github.com/ProfSynapse/claudesidian-mcp/blob/main/guide/recommended-system-prompt.md - Native chat guide: https://github.com/ProfSynapse/claudesidian-mcp/blob/main/guide/native-chat.md Start by figuring out whether I want native chat inside Obsidian, an external MCP agent, or both. Ask for my OS and the agent I want to use if that matters. Then walk me through the exact setup path, one step at a time. When a config file needs to be edited, show the exact snippet with my vault path inserted. Do not invent config formats or skip restart/reload steps. If multiple setup paths are possible, recommend the simplest one first.
- Workspace memory
- Task management
- Semantic search
- Adaptive search
- Native chat
- Inline editing
- Apps
- Workflow examples
- Two-tool architecture
- Nexus CLI
npm install npm run dev npm run build npm run test npm run lint
MCP server for Apple Notes with semantic search and CRUD operations. Claude searches, reads, creates, updates, and manages your Apple Notes through natural language.
A Model Context Protocol (MCP) Server for https://joplinapp.org/ that enables note access through the https://modelcontextprotocol.io. Perfect for integration with AI assistants like Claude.
A service for reading, writing, and managing markdown documentation with frontmatter metadata.
Connect your AI assistant to your personal knowledge base. Search, save links, create notes and to-dos. AI processes everything automatically.
An MCP server for interacting with Obsidian notes. Requires the OBSIDIAN_VAULT_PATH environment variable to be set.
Interact with your Obsidian vault using natural language.
Interact with your Obsidian vault using the Local REST API plugin, enabling LLMs to access and manage your notes.
Interact with your Obsidian notes and vaults using the Local REST API plugin.
A server for interacting with your Obsidian vault.
Interact with Obsidian vaults to read, create, edit, and manage notes and tags.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





