# Obsidian Rest Mcp

> Obsidian MCP server wrapping the Obsidian Local REST API

- **Type:** MCP server
- **Install:** `agentstack add mcp-alexw00-obsidian-rest-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [AlexW00](https://agentstack.voostack.com/s/alexw00)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [AlexW00](https://github.com/AlexW00)
- **Source:** https://github.com/AlexW00/obsidian-rest-mcp

## Install

```sh
agentstack add mcp-alexw00-obsidian-rest-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Obsidian REST MCP

An MCP (Model Context Protocol) server that wraps the [Obsidian Local REST API](https://github.com/coddingtonbear/obsidian-local-rest-api) plugin, enabling AI assistants to interact with your Obsidian vault.

Built with [FastMCP](https://gofastmcp.com/) - automatically generates tools from the OpenAPI specification.

## Why this server

Most MCP wrappers for REST APIs are maintained by manually re-implementing each endpoint as a bespoke tool. That approach tends to drift over time: when the underlying REST API adds/renames/changes endpoints, the MCP server needs a code update (and a new release) to catch up.

This server is different: it **dynamically generates tools directly from the Obsidian Local REST API OpenAPI spec**.

- **Stays in sync with the REST API**: when the plugin’s OpenAPI spec changes, this server’s tool surface updates automatically (no hand-updating dozens of wrappers).
- **Less breakage / less maintenance**: fewer places for the MCP implementation to get out of date compared to the plugin.
- **Full coverage**: you get the complete set of documented endpoints exposed as tools.

## Prerequisites

1. [Obsidian](https://obsidian.md/) with the [Local REST API](https://github.com/coddingtonbear/obsidian-local-rest-api) plugin installed and enabled
2. Docker

## Configuration

Get your API key from **Obsidian Settings → Local REST API**.

### Environment Variables

| Variable                | Description                                 | Default                   |
| ----------------------- | ------------------------------------------- | ------------------------- |
| `OBSIDIAN_API_KEY`      | API key from Obsidian Local REST API plugin | (required)                |
| `OBSIDIAN_REST_URL`     | Base URL of the REST API                    | `https://127.0.0.1:27124` |
| `OBSIDIAN_OPENAPI_PATH` | Path to OpenAPI spec                        | `/openapi.yaml`           |

## Usage

### VS Code (MCP)

See the checked-in VS Code MCP configuration at `.vscode/mcp.json`.

> **Note:** On macOS/Windows, containers can usually reach services on your machine via `https://host.docker.internal:27124`.
> On Linux, you may need `--network=host` (or an equivalent host gateway setup) for the container to reach the Obsidian REST API.

## Available Tools

This server exposes all endpoints from the Obsidian Local REST API.

Documentation (Swagger): https://coddingtonbear.github.io/obsidian-local-rest-api/

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [AlexW00](https://github.com/AlexW00)
- **Source:** [AlexW00/obsidian-rest-mcp](https://github.com/AlexW00/obsidian-rest-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-alexw00-obsidian-rest-mcp
- Seller: https://agentstack.voostack.com/s/alexw00
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.