Skip to main content
Glama
nuuuri

obsidian-mcp

by nuuuri

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

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    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.
    6,104
    9
    MIT
  • A
    license
    A
    quality
    B
    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
    20
    13
    MIT
  • F
    license
    -
    quality
    D
    maintenance
    A Python MCP server that gives Claude long-term memory and full context of everything by connecting to an Obsidian vault, enabling context retrieval, note management, and automatic graph linking.
  • A
    license
    -
    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

View all related MCP servers

Related MCP Connectors

  • Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer

  • Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.

  • Augments MCP Server - A comprehensive framework documentation provider for Claude Code

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nuuuri/obsidian-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server