Skip to main content
Glama
Sign In
obsidian-mcp

obsidian-mcp

by nuuuri
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Obsidian MCP Server

Claude와 Obsidian Vault를 양방향으로 연결하는 MCP(Model Context Protocol) 서버입니다.

기능

노트 관리

  • list_notes - Vault 내 모든 노트 목록 조회

  • read_note - 노트 읽기 (frontmatter, 링크, 태그 포함)

  • create_note - 새 노트 생성 (YAML frontmatter 지원)

  • update_note - 노트 내용 수정

  • update_frontmatter - frontmatter만 수정

  • append_to_note - 노트 끝에 내용 추가

  • delete_note - 노트 삭제

검색 및 그래프

  • search_notes - 전문 검색 (폴더/태그 필터 지원)

  • get_backlinks - 특정 노트를 참조하는 노트 조회

  • get_graph - 노트 간 연결 그래프 데이터

Daily Notes

  • get_daily_note - 특정 날짜의 Daily Note 조회

  • create_daily_note - Daily Note 생성 (템플릿 지원)

  • append_to_daily_note - Daily Note에 내용 추가

  • list_daily_notes - Daily Notes 목록 조회

Related MCP server: obsidian-pkm

설치

cd ~/obsidian-mcp
npm install
npm run build

설정

Claude Desktop 설정

~/Library/Application Support/Claude/claude_desktop_config.json 파일을 수정하세요:

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/obsidian-mcp/dist/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault",
        "OBSIDIAN_DAILY_NOTES_FOLDER": "Daily Notes",
        "OBSIDIAN_DAILY_NOTES_FORMAT": "YYYY-MM-DD"
      }
    }
  }
}

Claude Code 설정

~/.claude/settings.json 또는 프로젝트의 .claude/settings.json에 추가:

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/obsidian-mcp/dist/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault",
        "OBSIDIAN_DAILY_NOTES_FOLDER": "Daily Notes",
        "OBSIDIAN_DAILY_NOTES_FORMAT": "YYYY-MM-DD"
      }
    }
  }
}

환경 변수

변수

설명

필수

기본값

OBSIDIAN_VAULT_PATH

Obsidian Vault 경로

Yes

-

OBSIDIAN_DAILY_NOTES_FOLDER

Daily Notes 폴더 경로

No

Daily Notes

OBSIDIAN_DAILY_NOTES_FORMAT

Daily Notes 파일명 형식

No

YYYY-MM-DD

사용 예시

Claude에게 요청할 수 있는 것들

"내 Obsidian에서 'project' 태그가 있는 노트들을 찾아줘"

"오늘 Daily Note에 '## 회의 메모\n- 새로운 기능 논의' 추가해줘"

"Projects 폴더에 'new-feature.md' 노트를 만들어줘"

"'API 설계' 노트를 참조하는 다른 노트들이 뭐가 있어?"

"최근 일주일 Daily Notes 목록 보여줘"

도구 사용 예시

노트 검색:

{
  "query": "프로젝트 계획",
  "folder": "Projects",
  "tags": ["active"]
}

노트 생성:

{
  "path": "Projects/new-feature.md",
  "content": "# 새 기능\n\n## 개요\n...",
  "frontmatter": {
    "tags": ["project", "feature"],
    "status": "planning"
  }
}

Daily Note에 추가:

{
  "content": "## 아이디어\n- [[새로운 기능]] 구현 방안",
  "date": "2025-01-06"
}

보안

  • 경로 순회 공격 방지

  • 심볼릭 링크 차단

  • 파일 크기 제한 (10MB)

  • 쿼리 길이 제한 (1000자)

개발

# 개발 모드 (파일 변경 시 자동 컴파일)
npm run dev

# 빌드
npm run build

# 실행
npm start

라이선스

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Resources

    Related MCP Connectors

    Related MCP Servers

    • obsidian-ai-curator

      nwant
      A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that gives Claude AI direct access to your Obsidian vault, enabling natural language search, note creation, file management, and automated workflows.
      7,721 npm
      10
      MIT

    • obsidian-pkm

      AdrianV101
      A
      license
      A
      quality
      D
      maintenance
      This MCP server enables Claude to interact with an Obsidian vault for persistent, structured memory, providing tools for note creation, semantic search, graph traversal, and session memory.
      18
      26 npm
      15
      MIT

    • Obsidian Research MCP

      wienkers
      A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server enabling Claude to read, write, search, and analyse your Obsidian vault with advanced research capabilities.
      1
      MIT