# Obsidian Vault MCP Server

> Obsidian Vault MCP Server is an open-source MCP server for knowledge and memory. Access Obsidian vaults via Local REST API - read, search, and interact with notes. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/oleksandrkucherenko/mcp-obsidian-via-rest
- **MCP Registry name:** io.github.OleksandrKucherenko/mcp-obsidian-via-rest
- **Categories:** knowledge and memory, security
- **Listing updated:** 2026-11-13

## About

Access Obsidian vaults via Local REST API - read, search, and interact with notes

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-obsidian-via-rest --env API_KEY='<API_KEY>' --env API_URLS='<API_URLS>' -- npx -y @oleksandrkucherenko/mcp-obsidian
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-obsidian-via-rest": {
      "command": "npx",
      "args": [
        "-y",
        "@oleksandrkucherenko/mcp-obsidian"
      ],
      "env": {
        "API_KEY": "<API_KEY>",
        "API_URLS": "<API_URLS>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-obsidian-via-rest": {
      "command": "npx",
      "args": [
        "-y",
        "@oleksandrkucherenko/mcp-obsidian"
      ],
      "env": {
        "API_KEY": "<API_KEY>",
        "API_URLS": "<API_URLS>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-obsidian-via-rest": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@oleksandrkucherenko/mcp-obsidian"
      ],
      "env": {
        "API_KEY": "<API_KEY>",
        "API_URLS": "<API_URLS>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-obsidian-via-rest": {
      "command": "npx",
      "args": [
        "-y",
        "@oleksandrkucherenko/mcp-obsidian"
      ],
      "env": {
        "API_KEY": "<API_KEY>",
        "API_URLS": "<API_URLS>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-obsidian-via-rest": {
      "command": "npx",
      "args": [
        "-y",
        "@oleksandrkucherenko/mcp-obsidian"
      ],
      "env": {
        "API_KEY": "<API_KEY>",
        "API_URLS": "<API_URLS>"
      }
    }
  }
}
```

## FAQ

### Is Obsidian Vault MCP Server free?

Yes. Obsidian Vault MCP Server is open source, so you can use and self-host it for free.

### How do I add Obsidian Vault MCP Server to Claude Code?

Run this command in your terminal: claude mcp add mcp-obsidian-via-rest --env API_KEY='<API_KEY>' --env API_URLS='<API_URLS>' -- npx -y @oleksandrkucherenko/mcp-obsidian

### What are the best alternatives to Obsidian Vault MCP Server?

The closest alternatives to Obsidian Vault MCP Server are REA, Codebase Memory, XERJ, Claude Code Ultimate Guide and Nautilus Compass Memory.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.

---
Source: https://ai-powered.com/mcp/obsidian-vault-mcp-server
