MarkusPfundstein/mcp-obsidian

MarkusPfundstein/mcp-obsidian

от markuspfundstein
Управляет заметками Obsidian: ищет по ключевым словам, читает, дополняет и создаёт новые. Требуется плагин Local REST API.

MCP server for Obsidian

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

server for Obsidian MCP server

Components

Tools

The server implements multiple tools to interact with Obsidian:

  • list_files_in_vault: Lists all files and directories in the root directory of your Obsidian vault
  • list_files_in_dir: Lists all files and directories in a specific Obsidian directory
  • get_file_contents: Return the content of a single file in your vault.
  • search: Search for documents matching a specified text query across all files in the vault
  • patch_content: Insert content into an existing note relative to a heading, block reference, or frontmatter field.
  • append_content: Append content to a new or existing file in the vault.
  • delete_file: Delete a file or directory from your vault.
Example prompts

Its good to first instruct Claude to use Obsidian. Then it will always call the tool.

The use prompts like this:

  • Get the contents of the last architecture call note and summarize them
  • Search for all files where Azure CosmosDb is mentioned and quickly explain to me the context in which it is mentioned
  • Summarize the last meeting notes and put them into a new note 'summary meeting.md'. Add an introduction so that I can send it via email.

Часто задаваемые вопросы

Инструменты были проиндексированы:
obsidian_append_content

Добавляет содержимое в новый или существующий файл в хранилище.

Параметры
  • contentstringобязательный

    Содержимое для добавления в файл

  • filepathstringобязательный

    Путь к файлу (относительно корня хранилища)

obsidian_batch_get_file_contents

Возвращает содержимое нескольких файлов в вашем хранилище, объединённое с заголовками.

Параметры
  • filepathsstring[]обязательный

    Список путей к файлам для чтения

obsidian_complex_search

Выполняет сложный поиск документов по JsonLogic-запросу. Поддерживает стандартные операторы JsonLogic, а также 'glob' и 'regexp' для сопоставления с шаблоном. Результаты не должны быть falsy. Используйте этот инструмент, когда нужен сложный поиск, например поиск всех документов с определёнными тегами и т.д.

Параметры
  • queryobjectобязательный

    Объект запроса JsonLogic. Пример: {"glob": ["*.md", {"var": "path"}]} сопоставляет все файлы Markdown.

obsidian_delete_file

Удаляет файл или каталог из хранилища.

Параметры
  • confirmbooleanобязательный

    Подтверждение удаления файла (должно быть true)

  • filepathstringобязательный

    Путь к файлу или директории для удаления (относительно корня хранилища)

obsidian_get_file_contents

Возвращает содержимое одного файла в вашем хранилище.

Параметры
  • filepathstringобязательный

    Путь к соответствующему файлу (относительно корня вашего хранилища).

obsidian_get_periodic_note

Получает текущую периодическую заметку за указанный период.

Параметры
  • periodenumобязательный

    Тип периода (дневной, недельный, месячный, квартальный, годовой)

obsidian_get_recent_changes

Получает недавно изменённые файлы в хранилище.

Параметры
  • daysinteger

    Включать только файлы, изменённые в течение указанного количества дней (по умолчанию: 90)

  • limitinteger

    Максимальное количество возвращаемых файлов (по умолчанию: 10)

obsidian_get_recent_periodic_notes

Получает самые свежие периодические заметки для указанного типа периода.

Параметры
  • include_contentboolean

    Нужно ли включать содержимое заметки (по умолчанию: false)

  • limitinteger

    Максимальное количество заметок для возврата (по умолчанию: 5)

  • periodenumобязательный

    Тип периода (дневной, недельный, месячный, квартальный, годовой)

obsidian_list_files_in_dir

Перечисляет все файлы и каталоги, которые есть в конкретном каталоге Obsidian.

Параметры
  • dirpathstringобязательный

    Путь для получения списка файлов (относительно корня вашего хранилища). Пустые каталоги не возвращаются.

obsidian_list_files_in_vault

Перечисляет все файлы и каталоги в корневом каталоге вашего хранилища Obsidian.

Параметры

Без параметров.

obsidian_patch_content

Вставляет содержимое в существующую заметку с привязкой к заголовку, ссылке на блок или полю frontmatter.

Параметры
  • contentstringобязательный

    Содержимое для вставки

  • filepathstringобязательный

    Путь к файлу (относительно корня хранилища)

  • operationenumобязательный

    Выполняемая операция (добавление, добавление в начало или замена)

  • targetstringобязательный

    Целевой идентификатор (путь заголовка, ссылка на блок или поле frontmatter)

  • target_typeenumобязательный

    Тип цели для патча

obsidian_simple_search

Выполняет простой поиск документов, соответствующих указанному текстовому запросу, по всем файлам в хранилище. Используйте этот инструмент, когда хотите выполнить простой текстовый поиск.

Параметры
  • context_lengthinteger

    Сколько контекста возвращать вокруг совпадающей строки (по умолчанию: 100)

  • querystringобязательный

    Выполняет простой поиск текста в хранилище.

0.2.3основная
0.2.2
0.2.1
0.2.0
0.1.0

Выберите клиент, чтобы установить MarkusPfundstein/mcp-obsidian:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "markuspfundstein-mcp-obsidian-lqadkp4rjv": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>",
        "OBSIDIAN_HOST": "<your_obsidian_host>",
        "OBSIDIAN_PORT": "<your_obsidian_port>"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "markuspfundstein-mcp-obsidian-lqadkp4rjv": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>",
        "OBSIDIAN_HOST": "<your_obsidian_host>",
        "OBSIDIAN_PORT": "<your_obsidian_port>"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "markuspfundstein-mcp-obsidian-lqadkp4rjv": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>",
        "OBSIDIAN_HOST": "<your_obsidian_host>",
        "OBSIDIAN_PORT": "<your_obsidian_port>"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"markuspfundstein-mcp-obsidian-lqadkp4rjv\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"mcp-obsidian\"],\"env\":{\"OBSIDIAN_API_KEY\":\"<YOUR_OBSIDIAN_API_KEY>\",\"OBSIDIAN_HOST\":\"<your_obsidian_host>\",\"OBSIDIAN_PORT\":\"<your_obsidian_port>\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "markuspfundstein-mcp-obsidian-lqadkp4rjv": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>",
        "OBSIDIAN_HOST": "<your_obsidian_host>",
        "OBSIDIAN_PORT": "<your_obsidian_port>"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add markuspfundstein-mcp-obsidian-lqadkp4rjv --env OBSIDIAN_API_KEY=<YOUR_OBSIDIAN_API_KEY> --env OBSIDIAN_HOST=<your_obsidian_host> --env OBSIDIAN_PORT=<your_obsidian_port> -- uvx mcp-obsidian

Либо через JSON-конфиг:

claude mcp add-json markuspfundstein-mcp-obsidian-lqadkp4rjv "{\"command\":\"uvx\",\"args\":[\"mcp-obsidian\"],\"env\":{\"OBSIDIAN_API_KEY\":\"<YOUR_OBSIDIAN_API_KEY>\",\"OBSIDIAN_HOST\":\"<your_obsidian_host>\",\"OBSIDIAN_PORT\":\"<your_obsidian_port>\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add markuspfundstein-mcp-obsidian-lqadkp4rjv --env OBSIDIAN_API_KEY=<YOUR_OBSIDIAN_API_KEY> --env OBSIDIAN_HOST=<your_obsidian_host> --env OBSIDIAN_PORT=<your_obsidian_port> -- uvx mcp-obsidian

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.markuspfundstein-mcp-obsidian-lqadkp4rjv]
command = "uvx"
args = ["mcp-obsidian"]

[mcp_servers.markuspfundstein-mcp-obsidian-lqadkp4rjv.env]
OBSIDIAN_API_KEY = "<YOUR_OBSIDIAN_API_KEY>"
OBSIDIAN_HOST = "<your_obsidian_host>"
OBSIDIAN_PORT = "<your_obsidian_port>"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите MarkusPfundstein/mcp-obsidian, а в поле команды запуска — строку ниже:
uvx mcp-obsidian

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "markuspfundstein-mcp-obsidian-lqadkp4rjv": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>",
        "OBSIDIAN_HOST": "<your_obsidian_host>",
        "OBSIDIAN_PORT": "<your_obsidian_port>"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "markuspfundstein-mcp-obsidian-lqadkp4rjv": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>",
        "OBSIDIAN_HOST": "<your_obsidian_host>",
        "OBSIDIAN_PORT": "<your_obsidian_port>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например markuspfundstein-mcp-obsidian-lqadkp4rjv.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: markuspfundstein-mcp-obsidian-lqadkp4rjv
    command: uvx
    args:
      - "mcp-obsidian"
    env:
      OBSIDIAN_API_KEY: <YOUR_OBSIDIAN_API_KEY>
      OBSIDIAN_HOST: <your_obsidian_host>
      OBSIDIAN_PORT: <your_obsidian_port>
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "markuspfundstein-mcp-obsidian-lqadkp4rjv": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>",
        "OBSIDIAN_HOST": "<your_obsidian_host>",
        "OBSIDIAN_PORT": "<your_obsidian_port>"
      }
    }
  }
}

Похожие MCP-сервера

aliasunder/vault-cortex

aliasunder/vault-cortex

от aliasunder

Сервер Vault Cortex предоставляет AI-ассистентам полнотекстовый поиск и структурированную память в Obsidian vault через Docker. 25 инструментов работают с заметками, ссылками и свойствами без плагинов.

TypeScript⭐ 30
smith-and-web/obsidian-mcp-server

smith-and-web/obsidian-mcp-server

от smith-and-web

MCP-сервер для интеграции AI-ассистентов с Obsidian: создавайте, читайте, редактируйте заметки, управляйте тегами и ищите по хранилищу через естественный язык. Полезен для автоматизации работы с за...

TypeScript⭐ 19
kj455/mcp-kibela

kj455/mcp-kibela

от kj455

MCP-сервер для интеграции AI-ассистентов с корпоративной базой знаний Kibela. Умеет искать заметки по ключевым словам, получать содержимое по ID или пути, создавать и редактировать записи — идеальн...

TypeScript⭐ 13
louis030195/easy-obsidian-mcp

louis030195/easy-obsidian-mcp

от louis030195

MCP-сервер для подключения AI-ассистентов (Claude, ChatGPT) к Obsidian: поиск, чтение и анализ связей между заметками. Полезен для пользователей Obsidian, которые хотят задействовать ИИ для работы ...

TypeScript⭐ 17
akseyh/bear-mcp-server

akseyh/bear-mcp-server

от akseyh

MCP-сервер для работы с заметками Bear Notes. Через SQLite читает все заметки, ищет по тексту и выводит теги. Интегрируется с MCP-клиентами (Claude Desktop) для автоматизации вашей базы знаний на m...

JavaScript⭐ 45
henilcalagiya/mcp-apple-notes

henilcalagiya/mcp-apple-notes

от henilcalagiya

MCP-сервер для автоматизации Apple Notes на macOS. Создавайте, редактируйте и удаляйте заметки и папки, ищите по ключевым словам. Работает с MCP-клиентами (Continue.dev, Claude Desktop). Основан на...

Python⭐ 52
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин