Lets AI agents and other applications browse and manage the documents in an Obsidian vault.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add obsidian-server-sunub --env VAULT_DIR_PATH='<VAULT_DIR_PATH>' -- npx -y @sunub/obsidian-mcp-server~/.codex/config.toml
[mcp_servers.obsidian-server-sunub]
command = "npx"
args = ["-y", "@sunub/obsidian-mcp-server"]
env = { VAULT_DIR_PATH = "<VAULT_DIR_PATH>" }
# codex mcp add obsidian-server-sunub --env VAULT_DIR_PATH='<VAULT_DIR_PATH>' -- npx -y @sunub/obsidian-mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"obsidian-server-sunub": {
"command": "npx",
"args": [
"-y",
"@sunub/obsidian-mcp-server"
],
"env": {
"VAULT_DIR_PATH": "<VAULT_DIR_PATH>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"obsidian-server-sunub": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sunub/obsidian-mcp-server"
],
"env": {
"VAULT_DIR_PATH": "<VAULT_DIR_PATH>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"obsidian-server-sunub": {
"command": "npx",
"args": [
"-y",
"@sunub/obsidian-mcp-server"
],
"env": {
"VAULT_DIR_PATH": "<VAULT_DIR_PATH>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"obsidian-server-sunub": {
"command": "npx",
"args": [
"-y",
"@sunub/obsidian-mcp-server"
],
"env": {
"VAULT_DIR_PATH": "<VAULT_DIR_PATH>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"obsidian-server-sunub": {
"command": "npx",
"args": [
"-y",
"@sunub/obsidian-mcp-server"
],
"env": {
"VAULT_DIR_PATH": "<VAULT_DIR_PATH>"
}
}
}
}Remote
claude mcp add --transport http obsidian-server-sunub https://server.smithery.ai/@sunub/obsidian-mcp-server/mcp --header 'Authorization: Bearer <SMITHERY_API_KEY>'~/.codex/config.toml
[mcp_servers.obsidian-server-sunub]
url = "https://server.smithery.ai/@sunub/obsidian-mcp-server/mcp"
bearer_token_env_var = "OBSIDIAN_SERVER_SUNUB_SMITHERY_API_KEY"
# codex mcp add obsidian-server-sunub --url https://server.smithery.ai/@sunub/obsidian-mcp-server/mcp --bearer-token-env-var OBSIDIAN_SERVER_SUNUB_SMITHERY_API_KEY
# export OBSIDIAN_SERVER_SUNUB_SMITHERY_API_KEY=<SMITHERY_API_KEY>~/.cursor/mcp.json
{
"mcpServers": {
"obsidian-server-sunub": {
"url": "https://server.smithery.ai/@sunub/obsidian-mcp-server/mcp",
"headers": {
"Authorization": "Bearer <SMITHERY_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"obsidian-server-sunub": {
"type": "http",
"url": "https://server.smithery.ai/@sunub/obsidian-mcp-server/mcp",
"headers": {
"Authorization": "Bearer <SMITHERY_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"obsidian-server-sunub": {
"httpUrl": "https://server.smithery.ai/@sunub/obsidian-mcp-server/mcp",
"headers": {
"Authorization": "Bearer <SMITHERY_API_KEY>"
}
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"obsidian-server-sunub": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://server.smithery.ai/@sunub/obsidian-mcp-server/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer <SMITHERY_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"obsidian-server-sunub": {
"url": "https://server.smithery.ai/@sunub/obsidian-mcp-server/mcp",
"headers": {
"Authorization": "Bearer <SMITHERY_API_KEY>"
}
}
}
}Environment variables
VAULT_DIR_PATH
Replace the placeholders with your own credentials and keep them out of version control.