How to install Obsidian MCP in Windsurf
To install Obsidian MCP in Windsurf, paste the "obsidian-mcp" block into ~/.codeium/windsurf/mcp_config.json and refresh the MCP panel in Cascade.
Built from the published package · server updated 13 days ago
- 1
Open the MCP config
In Windsurf, open Settings, then Cascade, then MCP servers, and choose to view the raw config.
- 2
Add the server
Paste this into mcp_config.json:
{ "mcpServers": { "obsidian-mcp": { "command": "npx", "args": [ "-y", "obsidian-mcp" ] } } } - 3
Refresh
Click refresh in the MCP panel. The server and its tools appear in Cascade.
Config file: ~/.codeium/windsurf/mcp_config.json
MCP servers run with your permissions. If Obsidian MCP needs an API key, add it under env in the config. Check its README.
Install Obsidian MCP in another app
Similar servers
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
Open-source Obsidian for MDX - edit local docs with agent assistance
A private persistent computer: files and a bash shell that survive between runs.
Questions
Does Obsidian MCP work in Windsurf?
Yes. Windsurf supports local and remote mcp servers, and Obsidian MCP installs with the steps above.
Obsidian MCP does not show up in Windsurf. What now?
Restart Windsurf fully, check the JSON is valid, and make sure Node.js (for npx) is installed. See common MCP errors and fixes.
Is Obsidian MCP safe?
It scores 83 of 100. Review the code before you install it, and only give it the access it needs. Grades and details.
