Cursor & Claude와 같은 AI 조수를 가능하게하는 경량 모델 Context Protocol (MCP) 서버는 Obsidian vault에 읽고 쓸 수 있습니다.

예제 상호 작용

• “오늘 만든 코드 변경을 설명하는 내일 서업에 대한 새로운 메모를 정리” (또한 Git을 사용)
• “프로젝트 아이디어에 대한 메모를 확인”
• “나는 재발견과 관련된 것을 확인합니다”

도구

자세히보기

1. **getAllFilenames **

• Obsidian vault의 모든 파일명 목록을 가져옵니다.
• 어떤 파일을 발견하는 데 유용한

2. **readMultipleFiles **

• Obsidian vault에서 지정된 파일의 내용을 검색
• 정확한 파일명, 부분적인 파일명, 또는 case-insensitive 일치 지원
• 각 파일의 내용은 '# File: filename’로 사전 설정되어 clear 식별

3. ** getOpenTodos **

• Obsidian vault의 Markdown 파일에서 모든 Open TODO 항목을 검색
• 체크박스 아이템 찾기(‘- [ ] )
• 파일 위치로 반환

쓰기

1. ** 업데이트파일 내용**

• 새로운 Markdown 콘텐츠를 가진 Obsidian vault에 지정된 파일의 내용을 업데이트
• 파일이 존재하지 않는 경우, 생성됩니다

Obsidian MCP Server

A lightweight Model Context Protocol (MCP) server that enables AI assistants like Cursor & Claude to read from and write to your Obsidian vault.

Example Interactions

• “Create a new note for standup tomorrow describing the code changes I’ve made today” (should also use Git)
• “Check my notes about project ideas”
• “Check what todos I have related to refactoring”

Tools

Read

1. getAllFilenames

   • Gets a list of all filenames in the Obsidian vault
   • Useful for discovering what files are available

2. readMultipleFiles

   • Retrieves the contents of specified files from the Obsidian vault
   • Supports exact filenames, partial filenames, or case-insensitive matches
   • Each file’s content is prefixed with ‘# File: filename’ for clear identification

3. getOpenTodos

   • Retrieves all open TODO items from markdown files in the Obsidian vault
   • Finds unchecked checkbox items (lines containing '- [ ] ')
   • Returns them with their file locations

Write

1. updateFileContent
   • Updates the content of a specified file in the Obsidian vault with new markdown content
   • If the file doesn’t exist, it will be created
   • Automatically creates any necessary directories

Install & build

npm install obsidian-mcp-server
npm run build

Integrating with Claude Desktop and Cursor

To use your MCP server with Claude Desktop add it to your Claude configuration:

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": [
        "obsidian-mcp-server/build/index.js",
        "/path/to/your/vault"
      ]
    }
  }
}

For Cursor go to the MCP tab Cursor Settings (command + shift + J). Add a server with this command:

node obsidian-mcp-server/build/index.js /path/to/your/vault

Comparison with Other Solutions

While this implementation is intentionally lightweight, other solutions like jacksteamdev/obsidian-mcp-tools offer a more feature-rich approach as an Obsidian plugin.

This standalone server has the advantage of direct filesystem access without requiring the Obsidian application to be running.

Resources

• Model Context Protocol Documentation
• MCP Servers Repository