Claude デスクトップ用の Apple Notes モデル コンテキスト プロトコル サーバー。

ローカルの Apple Notes データベースを読み取り、Claude Desktop に提供します。

クロードは、あなたが最も忘れていたメモを検索し、あなたについてさらに多くのことを知ることができるようになりました。

間違いが起こる可能性はありません。

コンポーネント

リソース

サーバーは、Apple Notes の読み取りと書き込みの機能を実装します。

ツール

サーバーは複数のプロンプトを提供します:

• get-all-notes : すべてのノートを取得します。

• read-note : 特定のノートの完全な内容を取得します。

• search-notes : ノートを検索します。

欠けている機能:

• 暗号化されたメモは処理されません (ZISPASSWORDPROTECTED)

• ピン留めされたノートのフィルタリングはサポートされていません

• クラウド同期ステータスの処理なし

• 添付ファイルのコンテンツを取得できません

• チェックリスト ステータス (ZHASCHECKLIST) はサポートされていません

• メモを作成または編集する機能はありません

Related MCP server: Bear MCP Server

クイックスタート

サーバーをインストールする

Claude 用にサーバーをローカルにインストールするには、 uvを使用することをお勧めします。

uvx apple-notes-mcp

または

uv pip install apple-notes-mcp

以下の説明に従って設定を追加します。

クロードデスクトップ

MacOS の場合: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

注意: uvへの直接パスを使用する必要があるかもしれません。which 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 ソリューションを検討する可能性があります。

発達

建築と出版

配布用のパッケージを準備するには:

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. パッケージディストリビューションをビルドします。

uv build

これにより、 dist/ディレクトリにソースとホイールのディストリビューションが作成されます。

3. 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

起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。

ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルをご覧ください。

ソースコード

ソースコードはGitHubで入手できます。

貢献

あなたのアイデアやフィードバックは、 Blueskyまたは問題をオープンして私に送ってください。