mcp-obsidian: community Obsidian MCP server

• Searches every note in your vault for words or a phrase

  Runs a plain text search across all files in the vault and returns the matching notes with a bit of surrounding text.

  Try: “Find every note that mentions the Q3 budget”

  Read · obsidian_simple_search

• Finds all notes with a given tag

  Lists the notes tagged with a tag you name, using tags in the note's properties and inline #tags, not the word appearing in normal text.

  Try: “Show me all notes tagged #project/website”

  Read · obsidian_search_by_tag

• Finds notes that match detailed rules, like path patterns or tags

  Searches with a structured query that can combine conditions such as file path patterns, tags and other note data, for searches a plain text match cannot do.

  Try: “Find all notes in the Clients folder that have a status of active”

  Read · obsidian_complex_search

• Reads one note in full

  Returns the full text of one note or file in the vault so the assistant can read, quote or summarize it.

  Try: “Read my note 'Architecture call 2026-10-28' and summarize it”

  Read · obsidian_get_file_contents

• Reads several notes at once

  Returns the text of several notes in one go, each under its own header, which is handy for comparing or summarizing a set of notes.

  Try: “Read my last three meeting notes and list the open action items”

  Read · obsidian_batch_get_file_contents

• Reads just a note's properties, like tags, aliases and status

  Returns only the properties block at the top of a note, such as tags, aliases and status fields, without the rest of the text.

  Try: “What status and tags does my 'Website redesign' note have?”

  Read · obsidian_get_frontmatter

• Lists the files and folders at the top of your vault

  Shows the files and folders in the top level of your vault so the assistant can see how it is organized.

  Try: “What folders are in my Obsidian vault?”

  Read · obsidian_list_files_in_vault

• Lists the files and folders inside one folder

  Shows the files and subfolders inside a folder you name in the vault.

  Try: “List the notes in my Meetings folder”

  Read · obsidian_list_files_in_dir

• Opens today's daily note, or this week's, month's or year's note

  Returns the current daily, weekly, monthly, quarterly or yearly note, either its text or its details.

  Try: “What did I write in today's daily note?”

  Read · obsidian_get_periodic_note

• Gets your most recent daily or weekly notes

  Returns the latest periodic notes of one type, such as the last several daily notes, so the assistant can look back over them.

  Try: “Summarize my daily notes from the past week”

  Read · obsidian_get_recent_periodic_notes

• Shows the notes you changed most recently

  Lists the files in the vault that were edited most recently. It needs the Dataview plugin turned on in Obsidian.

  Try: “Which notes did I edit in the last few days?”

  Read · obsidian_get_recent_changes

• Adds text to the end of a note, creating it if needed

  Adds new text to the end of a note without touching what is already there, and creates the note if it does not exist yet.

  Try: “Add 'Call the dentist' to the end of my To do note”

  Write · obsidian_append_content

• Adds or replaces text under a heading, block or property in a note

  Edits one part of an existing note: it can add text before or after, or replace, the content under a heading, at a block reference, or in a property, leaving the rest of the note alone.

  Try: “Under the Decisions heading in my project note, add that we picked Postgres”

  Write · obsidian_patch_content

• Creates a note or replaces a note's whole text

  Writes a new note, or replaces everything in an existing note with new text. Whatever was in the note before is lost.

  Try: “Create a note called 'summary meeting.md' with a summary of my last meeting”

  Delete · obsidian_put_content

• Deletes a note or a whole folder from your vault

  Removes a file or folder from the vault. The assistant has to confirm the deletion explicitly when it calls this.

  Try: “Delete the note 'Scratch draft' from my vault”

  Delete · obsidian_delete_file

Watch out for

• It can overwrite and delete notes

  One tool replaces a whole note and another deletes files or folders. Keep a backup or use Obsidian's file recovery before letting it edit. github.com

• File paths are not checked against the vault

  Paths containing ../ are passed on to the plugin unchecked; a fix is waiting as an open pull request. Do not ask it to work with files outside the vault. github.com

• Notes can hide instructions for the assistant

  A shared or web-clipped note can contain hidden text that tells the assistant to copy or delete other notes. Review what it plans to change in vaults that take in outside content. github.com

• It skips the plugin's certificate check

  The server does not verify the plugin's HTTPS certificate. That is fine on your own computer; do not point it at Obsidian on another machine over a shared network. github.com

Security advisories

In their words