obsidian-mcp

obsidian-mcp

10

The obsidian-mcp MCP Server is a Model Context Protocol server that integrates with Obsidian, providing tools to access and manage vault contents securely. It supports secure API integration with features like Windows path normalization and resource handling in JSON format.

obsidian-mcp MCP Server

A Model Context Protocol server for Obsidian integration. This TypeScript-based server demonstrates core MCP concepts by providing integration with Obsidian through:

  • Resources: Access Obsidian server info and vault contents in JSON format.
  • Tools: Retrieve structured vault content via API tools.
  • API Integration: Secure connection with Obsidian API and custom axios client.

Features

  • Secure HTTPS connection
  • JSON format for easy integration
  • Windows path normalization support

Development

  • Requires Node.js v18+, TypeScript 5.3+
  • Setup: Install dependencies, build and start the server for development

Installation

  • Configuration for Claude Desktop on MacOS and Windows

Debugging

  • Use MCP Inspector for debugging with command npm run inspector

Dependencies

  • Runtime and Development: MCP SDK, axios, TypeScript