obsidian-cli-rest

Overview

This plugin transforms Obsidian's command-line interface into a programmatic API accessible through both REST endpoints and MCP protocol. It exposes virtually all Obsidian CLI commands organized into categories like files, search, properties, daily notes, tasks, and more. The server runs locally with API key authentication and can be configured for network access. Its MCP implementation uses a 'Code Mode' pattern with just two tools (search and execute) that enable progressive discovery of all commands regardless of their number.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• search

  Discover commands by name, description, or category

  Try:List all file management commandsTry:Show me search-related commandsTry:Find commands related to daily notes
• execute

  Run any CLI command by name

  Try:List all files in vaultTry:Create a new note named 'Meeting Notes'Try:Search for 'project planning'
• files

  List files in your vault

  Try:Show all files in my vaultTry:List markdown files in the documents folder
• create

  Create new notes

  Try:Create a new note titled 'Project Ideas'Try:Make a note called 'Shopping List' with content 'Milk, Eggs, Bread'
• read

  Read content of existing notes

  Try:Show me the content of 'Project Plan'Try:Read my daily note from yesterday
• append

  Add content to the end of notes

  Try:Add 'TODO: Review budget report' to my notesTry:Append '- Finish presentation' to my tasks
• property:set

  Set frontmatter properties in notes

  Try:Set status to 'completed' for the 'Project Plan' noteTry:Add a 'category' property of 'work' to my notes
• daily:read

  Read today's daily note

  Try:Show me today's daily noteTry:What tasks did I have for today?
• tags

  List tags and get tag information

  Try:Show all tags in my vaultTry:Find all notes tagged with 'project'
• tasks

  List and manage tasks

  Try:Show all incomplete tasksTry:List tasks with high priority
• plugins

  List, install, enable, disable, and uninstall plugins

  Try:Show all installed pluginsTry:Enable the 'Kanban' plugin
• templates

  List, read, and insert templates

  Try:Show all available templatesTry:Insert the 'Meeting Notes' template into a new note

Comparable tools

Installation

{
  "mcpServers": {
    "obsidian": {
      "command": "http",
      "args": ["http://127.0.0.1:27124/mcp"],
      "env": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

FAQ

Is this plugin secure for network access?

By default it only runs on localhost. For network access, you can change the bind address to 0.0.0.0 in settings, but an API key is always required. Dangerous commands are blocked by default.

How many MCP tools are exposed?

Only two tools are exposed regardless of the number of CLI commands: 'search' to discover commands, and 'execute' to run them. This follows the 'Code Mode' pattern for efficient discovery.

Compare obsidian-cli-rest with