Advanced MCP server for interacting with Obsidian via the Local REST API community plugin. It empowers AI agents (like Claude) to deeply understand your vault's structure, links, and content—beyond basic read/write operations.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add advanced-server-to-interact-with-obsidia --env OBSIDIAN_API_KEY='<OBSIDIAN_API_KEY>' --env OBSIDIAN_VAULT_PATH='<OBSIDIAN_VAULT_PATH>' -- uvx mcp-obsidian-advanced~/.codex/config.toml
[mcp_servers.advanced-server-to-interact-with-obsidia]
command = "uvx"
args = ["mcp-obsidian-advanced"]
env = { OBSIDIAN_API_KEY = "<OBSIDIAN_API_KEY>", OBSIDIAN_VAULT_PATH = "<OBSIDIAN_VAULT_PATH>" }
# codex mcp add advanced-server-to-interact-with-obsidia --env OBSIDIAN_API_KEY='<OBSIDIAN_API_KEY>' --env OBSIDIAN_VAULT_PATH='<OBSIDIAN_VAULT_PATH>' -- uvx mcp-obsidian-advanced~/.cursor/mcp.json
{
"mcpServers": {
"advanced-server-to-interact-with-obsidia": {
"command": "uvx",
"args": [
"mcp-obsidian-advanced"
],
"env": {
"OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>",
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"advanced-server-to-interact-with-obsidia": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-obsidian-advanced"
],
"env": {
"OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>",
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"advanced-server-to-interact-with-obsidia": {
"command": "uvx",
"args": [
"mcp-obsidian-advanced"
],
"env": {
"OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>",
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"advanced-server-to-interact-with-obsidia": {
"command": "uvx",
"args": [
"mcp-obsidian-advanced"
],
"env": {
"OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>",
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"advanced-server-to-interact-with-obsidia": {
"command": "uvx",
"args": [
"mcp-obsidian-advanced"
],
"env": {
"OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>",
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
}
}
}
}Environment variables
OBSIDIAN_API_KEYOBSIDIAN_VAULT_PATH
Replace the placeholders with your own credentials and keep them out of version control.