AIBase
EN
Explore
MCP Obsidian Via Rest
M

MCP Obsidian Via Rest

This is an MCP server that connects to the Obsidian note - taking software via REST API, providing note content retrieval, search, and semantic search functions. It supports multiple AI CLI tools and Docker deployment, and has the ability of automatic failover and health monitoring.
Knowledge management and memoryNote-taking tools#Note Management#Knowledge Base Integration#AI Assistant Tools#REST API.TypeScript
2.5 points
8.5K
Open Site

Overview

Installation

Content Details

Alternatives

What is the MCP Obsidian Server?

The MCP Obsidian Server is an intelligent connector that allows various AI assistants (such as Claude, Gemini, etc.) to directly access your Obsidian note library. Through this server, AI can search your notes, read specific content, and perform semantic analysis to help you better manage and utilize your personal knowledge base.

How to use MCP Obsidian?

The usage process is divided into three simple steps: 1) Enable the REST API plugin in Obsidian and obtain the API key; 2) Configure your preferred AI assistant (Claude, Gemini, etc.) to connect to the MCP server; 3) Start using natural - language instructions to let the AI assistant search and analyze your notes.

Applicable scenarios

Suitable for researchers, students, developers, and knowledge workers who need to frequently consult a large number of notes. It is especially suitable for scenarios such as academic research material organization, project document management, personal knowledge base search, meeting note analysis, and learning material summarization.

Main Features

Intelligent Note Search
Supports both keyword search and semantic search modes, capable of accurately finding relevant note content
Multi - URL Automatic Switching
Automatically tests multiple connection addresses, selects the fastest connection, and automatically switches to a backup address in case of connection failure
Self - Healing Ability
Checks the connection status every 30 seconds and automatically reconnects to the failed service to ensure continuous service availability
Multiple Connection Methods
Supports two transport protocols, Stdio (local) and HTTP (remote), to adapt to different usage scenarios
Support for Mainstream AI Tools
Compatible with mainstream AI command - line tools such as Claude Code, Gemini, OpenCode, Kilo Code, Codex, and GitHub Copilot
Docker Containerization
Provides a Docker image to simplify the deployment process and support cross - platform operation
Advantages
Seamlessly connect AI with the personal knowledge base to improve knowledge utilization efficiency
Automatic failover ensures high service availability
Support multiple AI tools, offering flexible user choices
Simple configuration with detailed setup guides
Open - source and free, with an active community and continuous updates
Limitations
Requires the Obsidian desktop version and the REST API plugin
Initial configuration requires certain technical knowledge
Manual adjustment of firewall settings may be required in complex network environments
Only supports the Obsidian note - taking application and is not compatible with other note - taking software

How to Use

Install the Obsidian REST API Plugin
Enable the 'Local REST API' plugin in Obsidian settings and copy the generated API key
Select an AI Tool and Configure MCP
According to the AI tool you use (Claude, Gemini, etc.), set up the MCP server according to the corresponding configuration guide
Set Environment Variables
Configure the API key and connection address. It is recommended to use multi - URL configuration for better stability
Test the Connection
Run the test command to verify if the connection is successful and ensure that the AI assistant can access your notes

Usage Examples

Research Material Organization
Graduate students need to organize a large number of literature notes and use an AI assistant to quickly find relevant research methods and conclusions
Project Progress Tracking
Project managers need to understand the current status and to - do items of multiple projects
Study Note Review
Students need to review all study notes on a certain topic to prepare for an exam

Frequently Asked Questions

What software do I need to install to use MCP Obsidian?
Why can't I connect to the Obsidian API?
Which AI tools are supported?
Is my note data secure?
Can I use it on multiple devices?

Related Resources

GitHub Repository
Project source code and latest updates
NPM Package
Install MCP Obsidian via NPM
Docker Image
Docker containerized deployment
Obsidian Official Website
Official website of the Obsidian note - taking application
MCP Protocol Documentation
Official specification of the Model Context Protocol

Installation

Copy the following command to your Client for configuration
{
  "mcpServers": {
    "obsidian": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "API_KEY", "-e", "API_URLS",
        "ghcr.io/oleksandrkucherenko/obsidian-mcp:latest"],
      "env": {
        "API_KEY": "<your-obsidian-api-key>",
        "API_URLS": "[\"https://host.docker.internal:27124\"]"
      }
    }
  }
}

{
  "mcpServers": {
    "obsidian": {
      "command": "bunx",
      "args": ["-y", "@oleksandrkucherenko/mcp-obsidian"],
      "env": {
        "API_KEY": "<your-obsidian-api-key>",
        "API_URLS": "[\"https://127.0.0.1:27124\"]"
      }
    }
  }
}

{
  "mcpServers": {
    "obsidian-http": {
      "type": "streamable-http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

{
  "mcpServers": {
    "obsidian": {
      "type": "local",
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "API_KEY", "-e", "API_URLS",
        "ghcr.io/oleksandrkucherenko/obsidian-mcp:latest"],
      "env": {
        "API_KEY": "${OBSIDIAN_API_KEY}",
        "API_URLS": "[\"https://host.docker.internal:27124\"]"
      },
      "tools": ["*"]
    }
  }
}

{
  "mcpServers": {
    "obsidian": {
      "type": "local",
      "command": "bunx",
      "args": ["-y", "@oleksandrkucherenko/mcp-obsidian"],
      "env": {
        "API_KEY": "${OBSIDIAN_API_KEY}",
        "API_URLS": "[\"https://127.0.0.1:27124\"]"
      },
      "tools": ["*"]
    }
  }
}
Note: Your key is sensitive information, do not share it with anyone.

Alternatives

A
Airweave
Airweave is an open - source context retrieval layer for AI agents and RAG systems. It connects and synchronizes data from various applications, tools, and databases, and provides relevant, real - time, multi - source contextual information to AI agents through a unified search interface.
Python
16.3K
5 points
V
Vestige
Vestige is an AI memory engine based on cognitive science. By implementing 29 neuroscience modules such as prediction error gating, FSRS - 6 spaced repetition, and memory dreaming, it provides long - term memory capabilities for AI. It includes a 3D visualization dashboard and 21 MCP tools, runs completely locally, and does not require the cloud.
Rust
9.7K
4.5 points
M
Moltbrain
MoltBrain is a long-term memory layer plugin designed for OpenClaw, MoltBook, and Claude Code, capable of automatically learning and recalling project context, providing intelligent search, observation recording, analysis statistics, and persistent storage functions.
TypeScript
9.3K
4.5 points
B
Bm.md
A feature-rich Markdown typesetting tool that supports multiple style themes and platform adaptation, providing real-time editing preview, image export, and API integration capabilities
TypeScript
16.1K
5 points
H
Haiku.rag
Haiku RAG is an intelligent retrieval - augmented generation system built on LanceDB, Pydantic AI, and Docling. It supports hybrid search, re - ranking, Q&A agents, multi - agent research processes, and provides local - first document processing and MCP server integration.
Python
18.0K
5 points
C
Cipher
Cipher is an open-source memory layer framework designed for programming AI agents. It integrates with various IDEs and AI coding assistants through the MCP protocol, providing core functions such as automatic memory generation, team memory sharing, and dual-system memory management.
TypeScript
0
5 points
A
Apple Notes MCP
A server that provides local Apple Notes database access for the Claude desktop client, supporting reading and searching of note content.
Python
15.6K
4.3 points
M
MCP Server Weread
The WeRead MCP Server is a lightweight service that bridges WeRead data and AI clients, enabling in - depth interaction between reading notes and AI.
TypeScript
14.8K
4 points
N
Notion Api MCP
Certified
A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.
Python
23.2K
4.5 points
G
Gitlab MCP Server
Certified
The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.
TypeScript
28.7K
4.3 points
M
Markdownify MCP
Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.
TypeScript
39.5K
5 points
D
Duckduckgo MCP Server
Certified
The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.
Python
81.2K
4.3 points
F
Figma Context MCP
Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.
TypeScript
70.3K
4.5 points
U
Unity
Certified
UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.
C#
37.7K
5 points
M
Minimax MCP Server
The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.
Python
56.8K
4.8 points
G
Gmail MCP Server
A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.
TypeScript
25.3K
4.5 points
AIBase
Zhiqi Future, Your AI Solution Think Tank
English简体中文繁體中文にほんご
© 2026AIBase