local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows reading from and interacting with Apple Notes database, including retrieving all notes, reading specific note content, and searching through notes
Integrates with the macOS file system to access Apple Notes database, requiring Full Disk Access permissions

Claude Desktop을 위한 Apple Notes 모델 컨텍스트 프로토콜 서버입니다.

로컬 Apple Notes 데이터베이스를 읽고 Claude Desktop에 제공하세요.

이제 클로드는 당신이 가장 잊고 있던 메모를 검색하여 당신에 대해 더 많이 알 수 있게 되었습니다.

잘못될 수 있다는 것을 알아두세요.

구성 요소

자원

이 서버는 Apple Notes를 읽고 쓸 수 있는 기능을 구현합니다.

도구

서버는 여러 가지 프롬프트를 제공합니다.

get-all-notes : 모든 노트를 가져옵니다.
read-note : 특정 노트의 전체 내용을 가져옵니다.
search-notes : 노트를 검색합니다.

누락된 기능:

암호화된 메모(ZISPASSWORDPROTECTED) 처리 불가
고정된 노트 필터링을 지원하지 않습니다.
클라우드 동기화 상태 처리 없음
첨부 파일 콘텐츠 검색이 누락되었습니다.
체크리스트 상태(ZHASCHECKLIST)에 대한 지원이 없습니다.
노트를 생성하거나 편집할 수 없습니다.

빠른 시작

서버를 설치하세요

Claude를 위해 로컬로 서버를 설치하려면 uv를 사용하는 것이 좋습니다.

지엑스피1

또는

uv pip install apple-notes-mcp

아래 설명한 대로 구성을 추가하세요.

클로드 데스크탑

MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

참고: uv 에 대한 직접 경로를 사용해야 할 수도 있습니다. which uv 사용하여 경로를 찾으세요.

개발/미공개 서버 구성

"mcpServers": {
  "apple-notes-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "{project_dir}",
      "run",
      "apple-notes-mcp"
    ]
  }
}

게시된 서버 구성

"mcpServers": {
  "apple-notes-mcp": {
    "command": "uvx",
    "args": [
      "apple-notes-mcp"
    ]
  }
}

Mac OS 디스크 권한

서버에 전체 디스크 접근 권한을 부여해야 합니다. Apple Notes SQLite 데이터베이스가 macOS 파일 시스템 깊숙이 중첩되어 있기 때문입니다.

나중에 이것이 더 불편하거나 Apple Notes에 추가/첨부 기능을 시작하려면 AppleScript 솔루션을 고려해 볼 수도 있습니다.

개발

건축 및 출판

배포를 위해 패키지를 준비하려면:

종속성 동기화 및 잠금 파일 업데이트:

uv sync

패키지 배포 빌드:

uv build

이렇게 하면 dist/ 디렉토리에 소스와 휠 배포판이 생성됩니다.

PyPI에 게시:

uv publish

참고: 환경 변수나 명령 플래그를 통해 PyPI 자격 증명을 설정해야 합니다.

토큰: --token 또는 UV_PUBLISH_TOKEN
또는 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME 및 --password / UV_PUBLISH_PASSWORD

디버깅

MCP 서버는 stdio를 통해 실행되므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector 사용을 강력히 권장합니다.

다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.

npx @modelcontextprotocol/inspector uv --directory {project_dir} run apple-notes-mcp

Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

소스 코드

소스 코드는 GitHub 에서 확인할 수 있습니다.

기여하다

여러분의 아이디어와 피드백을 Bluesky 에 보내거나 이슈를 개설해 주세요.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

AI가 로컬 Apple Notes 데이터베이스에서 읽을 수 있도록 허용합니다(macOS 전용)