Skip to main content
Glama
Sign In
enesjakozh

MCP Obsidian

by gregkonush
npmGitHub
TypeScript
MIT License
1,530
1
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP Obsidian

A server implementation of the Model Context Protocol (MCP) for integrating with Obsidian. This allows AI assistants to read, create, and manipulate notes in your Obsidian vault.

Features

  • Read the active file in Obsidian
  • Delete the active file
  • Insert content at specific positions (headings, block references, frontmatter)
  • Append content to files
  • Open specific files
  • List files in your vault
  • Search through your notes

Prerequisites

  • Bun runtime
  • Obsidian desktop application
  • An MCP-compatible AI assistant

Add to cursor

Place your secret in .env file

Choose command MCP and then enter this command

bun __REPO_PATH__/src/index.ts

Installation

  1. Clone this repository:
    git clone https://github.com/gregkonush/mcp-obsidian.git cd mcp-obsidian
  2. Install dependencies:
    bun install
  3. Copy the example environment file and configure it:
    cp .env.example .env

Configuration

Edit the .env file with your specific configurations:

OBSIDIAN_BASE_URL=http://localhost:27123 OBSIDIAN_TOKEN=your_token_here DEBUG=false

Usage

Start the MCP server:

bun run src/index.ts

The server will start and communicate with MCP-compatible AI assistants via standard I/O.

Available Tools

This implementation provides the following tools to AI assistants:

  • get_active_file - Returns the content of the currently active file
  • delete_active_file - Deletes the currently active file
  • insert_active_file - Modifies content relative to a heading, block reference, or frontmatter field
  • append_active_file - Appends content to the end of the active file
  • open_file - Opens a specific file in Obsidian
  • search_simple - Searches for documents matching a text query
  • list_files - Lists files in the root directory of your vault
  • list_directory_files - Lists files in a specific directory of your vault

Development

Project Structure

mcp-obsidian/ ├── src/ │ ├── index.ts # Main server implementation │ └── tools/ # Individual tool implementations │ ├── get-active-file.ts │ ├── delete-active-file.ts │ └── ... ├── .env # Environment configuration ├── package.json # Project dependencies └── tsconfig.json # TypeScript configuration

Adding New Tools

To add a new tool:

  1. Create a new file in the src/tools/ directory
  2. Implement the tool using the MCP SDK
  3. Import and register the tool in src/index.ts

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

A server implementation that allows AI assistants to read, create, and manipulate notes in Obsidian vaults through the Model Context Protocol.

  1. Features
    1. Prerequisites
      1. Add to cursor
        1. Installation
          1. Configuration
            1. Usage
              1. Available Tools
                1. Development
                  1. Project Structure
                  2. Adding New Tools
                2. License
                  1. Contributing

                    Related MCP Servers

                    • obsidian-mcp

                      StevenStavrakis
                      -
                      security
                      A
                      license
                      -
                      quality
                      Enables AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags.
                      Last updated -
                      598
                      149
                      TypeScript
                      MIT License
                      • Apple

                    • Obsidian MCP REST Server

                      PublikPrinciple
                      -
                      security
                      A
                      license
                      -
                      quality
                      Provides a standardized interface for AI assistants to interact with Obsidian vaults through a local REST API, enabling reading, writing, searching, and managing notes.
                      Last updated -
                      37
                      TypeScript
                      MIT License

                    • Obsidian MCP

                      newtype-01
                      -
                      security
                      F
                      license
                      -
                      quality
                      This project implements a Model Context Protocol (MCP) server for connecting AI models with Obsidian knowledge bases. Through this server, AI models can directly access and manipulate Obsidian notes, including reading, creating, updating, and deleting notes, as well as managing folder structures.
                      Last updated -
                      598
                      7
                      JavaScript

                    • HackMD MCP Server

                      yuna0x0
                      A
                      security
                      A
                      license
                      A
                      quality
                      A Model Context Protocol server that enables AI assistants to interact with the HackMD API for managing notes, including creating, reading, updating, and deleting notes.
                      Last updated -
                      12
                      122
                      21
                      TypeScript
                      MIT License

                    View all related MCP servers

                    Appeared in Searches

                    New MCP Servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/gregkonush/mcp-obsidian'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server