What is Obsidian Mcp Rest

Obsidian MCP REST is an implementation of an MCP server that provides access to Obsidian vaults through a local REST API, allowing AI assistants to interact with and manage Obsidian notes.

Use cases

Use cases include managing notes in Obsidian via AI assistants, automating note-taking processes, searching for specific notes, and integrating Obsidian with other applications that support MCP.

How to use

To use Obsidian MCP REST, first install the package globally using npm. Configure the Obsidian Local REST API plugin and create a configuration file. Start the server with the specified config file, and it will listen for MCP requests.

Key features

Key features include access to Obsidian vault contents, reading and writing notes, listing vault contents, search functionality, secure local REST API integration, and compatibility with Claude Desktop and other AI assistants.

Where to use

undefined

Obsidian MCP REST Server

An MCP (Model Context Protocol) server implementation that provides access to Obsidian vaults through a local REST API. This server allows AI assistants to interact with Obsidian notes and manage vault content through a standardized interface.

Features

• Access Obsidian vault contents through MCP
• Read and write notes
• List vault contents
• Search functionality
• Secure local REST API integration
• Compatible with Claude Desktop and other AI assistants

Prerequisites

• Node.js 16 or higher
• Obsidian with Local REST API plugin installed and configured
• An Obsidian vault with Local REST API enabled

Installation

Install the package globally:

npm install -g PublikPrinciple/obsidian-mcp-rest

Or if you prefer using a specific version/branch:

npm install -g PublikPrinciple/obsidian-mcp-rest#main

Configuration

1. First, configure Obsidian Local REST API plugin:

   • Install the Local REST API plugin in Obsidian
   • Configure the API port (default: 27123)
   • Generate and save an API key

2. Create a configuration file config.json:

{
  "obsidian": {
    "apiKey": "your-api-key-here",
    "port": 27123,
    "host": "localhost"
  },
  "server": {
    "name": "obsidian-mcp",
    "version": "1.0.0"
  }
}

Usage

1. Start the server:

obsidian-mcp-rest --config path/to/config.json

2. The server will start and listen for MCP requests via stdin/stdout.

Using with Claude Desktop

1. Configure Claude Desktop to use this MCP server:

   • Open Claude Desktop settings
   • Navigate to the MCP section
   • Add new server configuration:

     {
       "name": "obsidian-mcp",
       "command": "obsidian-mcp-rest",
       "args": [
         "--config",
         "path/to/config.json"
       ]
     }
     

2. Claude can now access your Obsidian vault through commands like:

   Read note "Projects/MyProject.md"
   List all notes in "Projects" folder
   Search for notes containing "typescript"
   

Available Tools

• listNotes: List all notes in the vault or a specific folder
• readNote: Read the contents of a specific note
• writeNote: Create or update a note
• searchNotes: Search for notes using a query string
• getMetadata: Get metadata for a specific note

Security

• The server only runs locally and communicates through stdin/stdout
• All requests to Obsidian REST API are authenticated with your API key
• No external network access is required
• Data remains local to your machine

Development

1. Clone the repository:

git clone https://github.com/PublikPrinciple/obsidian-mcp-rest.git
cd obsidian-mcp-rest

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Run tests:

npm test

Troubleshooting

Installation Issues

If you encounter any installation issues, try these alternatives:

1. Clone and install locally:

git clone https://github.com/PublikPrinciple/obsidian-mcp-rest.git
cd obsidian-mcp-rest
npm install
npm run build
npm install -g .

2. If you see TypeScript-related errors, ensure TypeScript is installed globally:

npm install -g typescript

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

License

MIT License - see LICENSE file for details