Note-Taking · Knowledge Management

Obsidian Semantic MCP

aaronsb/obsidian-semantic-mcp

Exciting News! We've taken everything we learned from this project and created something even better! Check out the new Obsidian MCP Plugin - a native Obsidian plugin that runs directly inside your vault with improved performance, simplified setup, and enhanced features.

Install

npx -y obsidian-semantic-mcp

Client configuration

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-semantic-mcp"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<OBSIDIAN_API_KEY>",
        "OBSIDIAN_API_URL": "<OBSIDIAN_API_URL>",
        "OBSIDIAN_VAULT_NAME": "<OBSIDIAN_VAULT_NAME>"
      }
    }
  }
}

Environment variables

OBSIDIAN_API_KEYOBSIDIAN_API_URLOBSIDIAN_VAULT_NAME
Author
@aaronsb
Category
Note-Taking, Knowledge Management
License
MIT
Updated
Oct 6, 2026

About Obsidian Semantic MCP

We encourage you to try it out!

A semantic, AI-optimized MCP server for Obsidian that consolidates 20 tools into 5 intelligent operations with contextual workflow hints.

Features

  • Simplified Interface: 5 semantic operations instead of 21+ individual tools

  • Contextual Workflows: Intelligent hints guide AI agents to the next logical action

  • State Tracking: Token-based system prevents invalid operations

  • Error Recovery: Smart recovery hints when operations fail

  • Fuzzy Matching: Resilient text editing that handles minor variations

  • Fragment Retrieval: Automatically returns relevant sections from large files to conserve tokens

  • Consolidates 20 tools into 5 semantic operations based on intent

  • Provides contextual workflow hints to guide next actions

  • Tracks state with tokens (inspired by Petri nets) to prevent nonsensical suggestions

  • Offers recovery hints when operations fail

Tools (6)

  • vault

    File and folder operations

  • edit

    Smart content editing

  • view

    Content viewing and navigation

  • workflow

    Get guided suggestions

  • system

    System operations

  • Operations

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS

Related MCP servers

More servers
Notion MCP Server (Official) logo

Notion MCP Server (Official)

makenotion/notion-mcp-server

1.5k

For the best experience, use Remote Notion MCP, our official hosted MCP server. This repository is a separate, self-hosted MCP server implementation that is no longer actively maintained or supported. Please use Remote Notion MCP instead.

Note-Taking
MCP Obsidian logo

MCP Obsidian

MarkusPfundstein/mcp-obsidian

750

MCP server to interact with Obsidian via the Local REST API community plugin.

Note-Taking
MCP Notion Server logo

MCP Notion Server

suekou/mcp-notion-server

671

This server targets the Notion API 2026-03-11 and uses the current database/data source model. It exposes MCP tools, prompts, resources, structured tool results, and optional MCP Apps for interactive Notion workflows.

Note-Taking
Obsidian MCP logo

Obsidian MCP

StevenStavrakis/obsidian-mcp

261

A local Model Context Protocol server that lets MCP-compatible assistants safely read and modify explicitly configured Obsidian vaults.

Note-Taking
MCP Apple Notes logo

MCP Apple Notes

RafalWilinski/mcp-apple-notes

187

A Model Context Protocol (MCP) server that enables semantic search and RAG (Retrieval Augmented Generation) over your Apple Notes. This allows AI assistants like Claude to search and reference your Apple Notes during conversations.

Note-Taking
notion_mcp logo

notion_mcp

danhilse/notion_mcp

171

A simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list through Claude. This is a basic implementation tailored specifically for my minimalist todo list setup in Notion.

Note-Taking