Apple MCP

🚀 Apple MCP tools

このプロジェクトは、MCPプロトコル用のAppleネイティブツールのコレクションです。Appleの様々なアプリケーションを操作するための便利なツールを提供します。

こちらにセットアップ方法のデモ付きステップバイステップのビデオがあります。 - https://x.com/DhravyaShah/status/1892694077679763671

{
  "mcpServers": {
    "apple-mcp": {
      "command": "bunx",
      "args": ["--no-cache", "apple-mcp@latest"]
    }
}

🚀 クイックスタート

📦 インストール

自動インストール

Smitheryを通じてClaude Desktop用のApple MCPを自動的にインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client claude

Cursor用の場合は、以下のコマンドを使用します。

npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client cursor

手動インストール

まず、bunをインストールする必要があります。以下のコマンドでインストールできます。

brew install oven-sh/bun/bun

次に、claude_desktop_config.jsonを以下の内容で編集します。

{
  "mcpServers": {
    "apple-mcp": {
      "command": "bunx",
      "args": ["@dhravya/apple-mcp@latest"]
    }
  }
}

💻 使用例

基本的な使用法

Claudeにapple-mcpツールを使用するように依頼します。

Can you send a message to John Doe?

find all the notes related to AI and send it to my girlfriend

create a reminder to "Buy groceries" for tomorrow at 5pm

✨ 主な機能

• メッセージ

  • Apple Messagesアプリを使用してメッセージを送信
  • メッセージを読み上げ

• メモ

  • メモを一覧表示
  • Apple Notesアプリでメモを検索して読む

• 連絡先

  • メッセージを送信するために連絡先を検索

• メール

  • 複数の受信者（To、Cc、Bcc）にファイル添付でメールを送信
  • カスタムクエリ、メールボックス選択、結果制限でメールを検索
  • メールを将来の日時に送信するようにスケジュール設定
  • スケジュールされたメールを一覧表示して管理
  • 全体またはメールボックスごとの未読メール数を確認

• リマインダー

  • すべてのリマインダーとリマインダーリストを一覧表示
  • テキストでリマインダーを検索
  • 任意の期限とメモで新しいリマインダーを作成
  • 特定のリマインダーを表示するためにRemindersアプリを開く

• カレンダー

  • カスタマイズ可能な日付範囲でカレンダーイベントを検索
  • 今後のイベントを一覧表示
  • タイトル、場所、メモなどの詳細を指定して新しいカレンダーイベントを作成
  • カレンダーイベントをCalendarアプリで開く

• ウェブ検索

  • DuckDuckGoを使用してウェブを検索
  • 検索結果からコンテンツを取得して処理

• マップ

  • 場所や住所を検索
  • 場所をお気に入りに保存
  • 場所間の経路を取得
  • マップ上にピンを置く
  • ガイドを作成して一覧表示
  • ガイドに場所を追加

• TODO: Apple Photosアプリで写真を検索して開く

• TODO: Apple Musicアプリで音楽を検索して開く

コマンドを連鎖させてワークフローを作成することもできます。例えば、以下のようなコマンドが有効です。

"can you please read the note about people i met in the conference, find their contacts and emails, and send them a message saying thank you for the time."

🔧 ローカル開発

ローカルで開発するには、以下の手順を実行します。

git clone https://github.com/dhravya/apple-mcp.git
cd apple-mcp
bun install
bun run index.ts

開発を楽しんでください！