obsidian-ai-miniserver 0.2.0

Expose your Obsidian vault via REST API and streamable HTTP MCP server for AI tool access

obsidian-ai-miniserver

Makes your Obsidian vault accessible via REST API (OpenAPI) and a streamable HTTP MCP server. Enables AI to find, read, and edit text notes. Supports multiple users with token-based auth and path-level access control.

What's good about it

• Works headless — runs without Obsidian present, unlike plugin-based solutions
• Token-efficient — optimized tool signatures and docs to save tokens
• Flexible tools — regex search across notes, batch requests, and more
• AI-managed access — one AI can admin other AI's access with path-level permissions
• Identical MCP and REST API — easy to build integrations against as well as connect AI

Quick start

pip install obsidian-ai-miniserver
obs_ai_ms start /path/to/vault --admin-token your_token

This starts both servers on their default ports. Connect your AI to the MCP endpoint or the REST API.

Options

Option	Default	Description
vault_path	(required)	Path to the Obsidian vault
--admin-token	(required)	Auth token for the admin user
--openapi-port	8747	Port for the REST API server (-1 to disable)
--mcp-port	8716	Port for the MCP server (-1 to disable)
--host	127.0.0.1	Host to bind to. Use 0.0.0.0 to allow remote access

Persistence

Config is stored at .obsidian/obsidian_ai_miniserver.json inside the vault — user list with tokens and path access rules.

API reference

See openapi.json for full request/response definitions.

All requests go to POST /api/obsidian with a kind field that discriminates the request type. Available kinds:

• get_vault_info — vault name, daily notes folder, your user info
• list_files — list files and folders at a path
• read_text — read a note's text
• write_text — overwrite a note
• append_text — append to a note
• replace_text — find and replace text in a note
• move_file — move, copy, or delete a file
• search_files — regex search across notes and text files with context snippets
• batch — send multiple requests in one call
• list_users / upsert_user — admin user management