# Obsidian (MCP Server)

> Read, search and edit Obsidian vault notes via the Local REST API

- Type: MCP server
- Publisher: Markus Pfundstein
- Categories: Productivity, Writing
- Website: https://github.com/MarkusPfundstein/mcp-obsidian
- Source: https://github.com/MarkusPfundstein/mcp-obsidian
- Transport: stdio
- Launch command: uvx mcp-obsidian
- Sign-in: api-key
- Environment variables: OBSIDIAN_API_KEY, OBSIDIAN_HOST, OBSIDIAN_PORT
- GitHub stars: 4456
- Listed: 2024-11-29

## About

Community MCP server that interacts with an Obsidian vault through the Local REST API community plugin. Supports listing files, reading notes, full-text search, and patching or appending content.

## Install

1. **Add the server to Codex**

   Codex CLI:

   ```bash
   codex mcp add obsidian --env OBSIDIAN_API_KEY=YOUR_OBSIDIAN_API_KEY --env OBSIDIAN_HOST=YOUR_OBSIDIAN_HOST --env OBSIDIAN_PORT=YOUR_OBSIDIAN_PORT -- uvx mcp-obsidian
   ```

   config.toml:

   ```toml
   [mcp_servers.obsidian]
   command = "uvx"
   args = ["mcp-obsidian"]
   
   [mcp_servers.obsidian.env]
   OBSIDIAN_API_KEY = "YOUR_OBSIDIAN_API_KEY"
   OBSIDIAN_HOST = "YOUR_OBSIDIAN_HOST"
   OBSIDIAN_PORT = "YOUR_OBSIDIAN_PORT"
   ```

   Agents SDK:

   ```python
   from agents import Agent, Runner
   from agents.mcp import MCPServerStdio
   
   async with MCPServerStdio(
       name="Obsidian",
       params={"command": "uvx", "args": ["mcp-obsidian"]},
   ) as server:
       agent = Agent(name="Assistant", mcp_servers=[server])
       result = await Runner.run(agent, "Summarize my last architecture call note")
       print(result.final_output)
   ```

## Tools

- `list_files_in_vault`
- `list_files_in_dir`
- `get_file_contents`
- `search`
- `patch_content`
- `append_content`
- `delete_file`

## Example prompts

- "Summarize my last architecture call note"
- "Search all notes mentioning Azure CosmosDb"
- "Create a note 'summary meeting.md' from my last meeting notes"
- "Append today's todo list to my daily note"

## Related

- [Notion](https://chatgptplugins.directory/mcp/notion.md): Search, read, and write Notion pages, databases, and comments via hosted MCP
- [Excalidraw](https://chatgptplugins.directory/mcp/excalidraw.md): Draw hand-drawn Excalidraw diagrams live inside ChatGPT, Claude and VS Code
- [Atlassian Rovo (Jira & Confluence)](https://chatgptplugins.directory/mcp/atlassian-rovo.md): Work with Jira issues and Confluence pages through Atlassian's hosted MCP
- [Browser Use](https://chatgptplugins.directory/mcp/browser-use.md): Run Browser Use cloud browser agents or control a local browser over MCP
- [Filesystem](https://chatgptplugins.directory/mcp/filesystem.md): Secure local file operations with configurable directory access
- [Memory](https://chatgptplugins.directory/mcp/memory.md): Knowledge graph-based persistent memory across conversations

---
Source: https://chatgptplugins.directory/mcp/obsidian · Index: https://chatgptplugins.directory/llms.txt · Independent and community-run. Not affiliated with or endorsed by OpenAI. ChatGPT is a trademark of OpenAI.