プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Apple Productivity MCP

作者:gambadioバージョン 3.0.0i★ 0iパソコンで動くリポジトリ ↗
レジストリ名io.github.gambadio/apple-productivity-mcp

インストール方法

What it does

Local macOS tools for Apple apps, iWork documents, files, media, and Shortcuts.

  • Connects パソコンで動く
  • Account or key No key needed
  • Category 文書・表計算・事務作業

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

MinerU

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

作者:opendatalab★ 83,9191 個の skill

Skill · 手順書ライセンス記載なし

watermarks-remover

A privacy-first app that strips AI watermarks from content you own.

作者:guillaumemeyer★ 27,7231 個の skill

Skill · 手順書

obsidian-skills

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

作者:kepano★ 53,104 (whole repo)5 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ7/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア7/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Apple Productivity MCP をインストールして。https://mcp.popnx.com/i/gambadio-apple-productivity-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月13日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Apple Productivity MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "apple-productivity": { "command": "npx", "args": [ "-y", "@gambadio/apple-productivity-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Apple Productivity MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "apple-productivity": {
          "command": "npx",
          "args": [
            "-y",
            "@gambadio/apple-productivity-mcp"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    Apple Productivity MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Apple Productivity MCP を使っていると言うか、回答に Apple Productivity MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Apple Productivity MCP につなげません

Apple Productivity MCP はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Apple Productivity MCP につなげるアプリを使う

  • 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)

B · 文書・表計算・事務作業 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Apple Productivity MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user apple-productivity -- npx -y @gambadio/apple-productivity-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Apple Productivity MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user apple-productivity -- npx -y @gambadio/apple-productivity-mcp
  4. Claude Code で /mcp と入力

    Apple Productivity MCP が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Apple Productivity MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Apple Productivity MCP を使っていると言うか、回答に Apple Productivity MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Apple Productivity MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "apple-productivity": { "command": "npx", "args": [ "-y", "@gambadio/apple-productivity-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Apple Productivity MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    Apple Productivity MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Apple Productivity MCP を使っていると言うか、回答に Apple Productivity MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Apple Productivity MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "apple-productivity": { "type": "stdio", "command": "npx", "args": [ "-y", "@gambadio/apple-productivity-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Apple Productivity MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    Apple Productivity MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Apple Productivity MCP を使っていると言うか、回答に Apple Productivity MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Apple Productivity MCP を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user apple-productivity -- npx -y @gambadio/apple-productivity-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "apple-productivity": {
      "command": "npx",
      "args": [
        "-y",
        "@gambadio/apple-productivity-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "apple-productivity": {
      "command": "npx",
      "args": [
        "-y",
        "@gambadio/apple-productivity-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "apple-productivity": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@gambadio/apple-productivity-mcp"
      ]
    }
  }
}

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
56/週
接続方法
パソコンで動く
最新バージョンi
3.0.0
レジストリ公開日i
2026年10月12日
コードの最終更新i
2026年10月12日
作者
gambadio
パッケージ
npm: @gambadio/apple-productivity-mcp
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント gambadio で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:38 日前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に @gambadio/apple-productivity-mcp@3.0.0 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月16日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/gambadio-apple-productivity-mcp.svg)](https://mcp.popnx.com/en/servers/gambadio-apple-productivity-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

文書・表計算・事務作業のほかのサーバーとの比較i

  • このカテゴリのほかの4110件のうち0%よりスターが多い
  • このカテゴリのほかの4110件のうち44%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの4110件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Apple Productivity MCPは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は38 日前、最新バージョン(3.0.0)がレジストリに届いたのは38 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

作者:HeyPuter広く使われている★ 4.4万5 か月前更新

クラウドで動く✓ 提供元 · puter.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

作者:getsentry広く使われている↓ 13万/週 共有パッケージの数★ 65854 か月前更新

パソコンで動く✓ 提供元 · xcodebuildmcp.com

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

作者:Vexa-ai広く使われている★ 29942 か月前更新

クラウドで動く✓ 提供元 · vexa.ai

Anki MCP Server

MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.

作者:ankimcp成長中↓ 1136/週★ 567先月更新

パソコンで動く✓ 提供元 · ankimcp.ai
似たものと比べる
これ
Apple Productivity MCP
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
動く場所パソコンにインストールが必要クラウドで動き、インストール不要パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要パソコンにインストールが必要
キーが必要いいえいいえいいえはいいいえいいえ
Claude で + から追加いいえいいえいいえいいえはいいいえ
基本チェック3/34/43/32/44/43/3
ライセンスMITAGPL-3.0MITApache-2.0Apache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Apple Productivity MCP

A local macOS MCP server for working with Apple's productivity apps, documents, files, and media from Codex, Claude Code, Claude Desktop, and other stdio MCP clients.

Version 3.0.0: 133 tools across 17 groups, plus optional execution of explicitly allowlisted Shortcuts. Runs on your Mac through Apple's automation interfaces. No hosted service, listening port, subscription, or Apple API key is required.

Tool reference · Machine-readable schemas · Verification · Source documentation · Changelog · Publishing · Directory status

What it can do

App / groupToolsCoverage
Mail12Accounts and mailboxes; message metadata/body; sender/subject search; visible drafts; send; read/flag status; move/trash; mailbox creation; attachments.
Calendar12Calendars and events; create/update/delete events; event notes, attendees and recurrence; calendar creation/rename/deletion; display alarms and event URLs.
Reminders15Accounts/lists; reminders and title search; notes, priorities and due dates; create/update/delete; list management; complete/reopen; flags and notification dates.
Notes9Accounts/folders; list/search/read notes; create folders and HTML notes; update and delete unlocked notes.
Contacts9Search and contact details; groups and members; create contacts/groups; update fields; add/remove group membership.
Pages8List/open/create documents; read/replace/append body text; save; export PDF/DOCX; close with unsaved-change protection.
Numbers11Documents, sheets, tables; create tables; read/write bounded cell ranges; save; export PDF/XLSX; close.
Keynote9Documents and slides; create presentations; add/update title, body and presenter notes; save; export PDF/PPTX; close.
TextEdit7Documents; create/open/read/replace/append text; save RTF; close.
Safari6Tabs and page text; open/navigate/close tabs with URL checks; Reading List.
Music9Playlists, tracks and search; metadata; create playlists and add tracks; playback and volume.
Photos9Albums/items/search; metadata; create albums; add items; import/export; update metadata.
Messages3Accounts/chats; send text to an explicit recipient through an explicit account.
Files8Bounded folder listing; metadata/text; create text files/folders; copy; Spotlight filename search; Finder Trash.
Finder2Selected item metadata; reveal an allowed path.
Shortcuts2 + 1 opt-inList shortcuts/folders; run only names in the configured allowlist.
System2Discover installed apps/configuration; launch a known Apple app.

The original 18 tool names remain supported. Version 3 expands the default catalog; select only the app groups you want below.

Coverage has boundaries. Apple does not expose every app feature through scripting. Messages history, Contacts deletion, Pages layout text boxes, full document styling, Calendar invitations, Reminders subtasks/tags/recurrence, arbitrary Safari JavaScript, and private Apple databases are not implemented. There are no dedicated Home, Health, Wallet, Find My, or Freeform editing tools. A user-created, allowlisted Shortcut can bridge supported actions in other apps. The complete input schemas describe exactly what each tool accepts.

Requirements

  • macOS and Node.js 20 or newer.
  • The Apple app you want to control must be installed and configured. Pages, Numbers, and Keynote are separate App Store installations.
  • A client supporting local stdio MCP servers.
  • macOS Automation permission for the launching client/process to control each app. Some file locations also require Files & Folders access.

The server starts when the MCP client connects. Each automation call uses a fixed script and JSON arguments with a timeout. iCloud, Exchange, or other account sync continues to follow the app's own settings.

Install

Codex
codex mcp add apple-productivity-local -- \

npx -y @gambadio/apple-productivity-mcp@latest codex mcp get apple-productivity-local

Claude Code
claude mcp add --transport stdio --scope user apple-productivity-local -- \

npx -y @gambadio/apple-productivity-mcp@latest claude mcp get apple-productivity-local

Claude Desktop and other JSON-configured clients

Add this to the client's MCP configuration, then restart it:

{

"mcpServers": { "apple-productivity-local": { "command": "npx", "args": ["-y", "@gambadio/apple-productivity-mcp@latest"] } } }

For a reproducible install, replace @latest with @3.0.0. A tested local .mcpb bundle and checksum are available in the GitHub release. See the packaging instructions to build one yourself. This package requires execution on the user's Mac and cannot access their apps from a Linux container or remote hosting service.

Configuration

All settings are optional. Put them in your MCP client's server environment and start a new MCP process.

VariableDefaultBehavior
APPLE_MCP_ENABLED_GROUPSAll groupsComma-separated group names from the table above, lowercase: e.g. mail,calendar,reminders,notes. Empty means all. Unknown groups fail startup.
APPLE_MCP_READ_ONLYfalse1 or true registers read-only tools only. 0 or false enables the selected groups' write tools as well.
APPLE_MCP_FILE_ROOTS[]JSON array of existing absolute directories for Files tools, Finder reveal, Mail attachment saving, and Shortcut file input. Required when using those operations. Paths resolving outside these roots are rejected.
APPLE_MCP_SHORTCUTS[]JSON array of shortcut names/identifiers permitted to run. An empty list omits apple_shortcuts_run entirely.

Example with Notes, reminders, files, and one permitted Shortcut:

{

"mcpServers": { "apple-productivity-local": { "command": "npx", "args": ["-y", "@gambadio/apple-productivity-mcp@3.0.0"], "env": { "APPLE_MCP_ENABLED_GROUPS": "system,notes,reminders,files,finder,shortcuts", "APPLE_MCP_FILE_ROOTS": "[\"/Users/YOUR_NAME/Documents\"]", "APPLE_MCP_SHORTCUTS": "[\"Prepare daily note\"]" } } } }

Replace YOUR_NAME and the shortcut name with values that exist on your Mac. An iCloud Drive directory can be included using its real local absolute path.

File roots constrain the generic file tools listed above; they are not a sandbox for Apple apps. iWork/TextEdit open/save/export and Photos import/export use explicit paths under the macOS permissions of those apps. Shortcuts may perform any action already contained in the allowed shortcut, including sending messages or changing data elsewhere. Inspect a shortcut before allowlisting it. App-group filtering and read-only mode control the exposed tool surface; MCP annotations are hints for clients, not an authorization system.

Example requests

  • “Find reminders with ‘invoice’ in the title, then show their notes and due dates.”
  • “Create a Notes folder in this account and put my meeting summary in it.”
  • “Read this Pages document and export a PDF beside it.”
  • “List the sheets and tables in my Numbers workbook, then fill cells B2:D6 with these values.”
  • “Add a Keynote slide with this title, body, and presenter notes.”
  • “Find Mail messages from this sender and save the selected attachment in my allowed Documents folder.”
  • “List my Photos albums and export these selected items into an empty folder.”
  • “Run my allowlisted ‘Prepare daily note’ shortcut.”

Start with discovery tools. Use returned IDs/names and inspect the tool schema for exact fields. apple_system_capabilities identifies installed apps but does not pre-authorize them or prove permissions. Write requests act on real data, so name the intended target and changes explicitly.

Data handling and safeguards

  • No server-side account, telemetry service, network listener, or credential storage.
  • Fixed JXA programs receive user values as JSON arguments, without interpolation into executable source. There is no arbitrary code or shell execution tool.
  • New file copies refuse replacement. Text writes and document save/export require an explicit overwrite option to replace a path. Photos exports require an empty folder.
  • Generic file operations require explicit roots and check resolved paths. File deletion goes through Finder Trash; there is no empty-Trash tool.
  • Collection reads and text/cell ranges have limits. Locked Notes are not read or modified. Safari tab mutations compare the expected URL to guard against shifted indices.
  • Read-only mode hides mutations. Every tool declares read-only, destructive, idempotent, and open-world annotations.
  • Email, Messages, document changes, reminders, contacts, and media edits may sync or reach other people. A send result means submission to the app, not independently verified delivery.
  • Timeouts or multi-step errors can leave partial changes. Inspect the target before retrying a write.
  • Data returned to an MCP client becomes part of that client's active model session and is governed by its data controls. Local execution does not mean content stays outside the model session. JSON inputs are visible to local processes with sufficient OS privileges.

Development and verification

npm ci

npm test npm run docs:tools npm audit --omit=dev npm pack --dry-run

Tests execute the static automation programs against application fixtures, exercise filesystem boundaries in temporary folders, and initialize the actual stdio MCP server. They do not send messages or edit personal app data.

For the existing read-only Mail/Calendar/Reminders integration suite, after granting Automation permission:

npm run test:integration

Live verification is app-specific. Pages, Numbers, and Keynote were not installed on the release development Mac; their tools have fixture coverage but no live iWork verification. See verification results and limitations and implementation sources. Do not interpret the tool count as a claim that every operation has been exercised against every app/macOS version.

Troubleshooting

Automation unavailable / not authorized / timeout: open System Settings → Privacy & Security → Automation and permit the relevant Apple app for the launching client. A timeout can also reflect a busy app or slow iCloud data; do not blindly retry writes. Restart the client after permission/configuration changes.

Application cannot be found: install the app, launch it once, and verify apple_system_capabilities. OS process sandboxing can also restrict LaunchServices. Run a local client with the appropriate macOS access.

File roots required / path outside allowed roots: configure APPLE_MCP_FILE_ROOTS as a JSON array of existing absolute directories. A symlink cannot be used to escape that list. Create missing parent folders first.

Object not found / ambiguous name: rediscover the app's current account, list, document, or object ID. Names differ by language/provider. Close or rename duplicate documents before editing by name.

Contacts has unsaved changes: save or discard your pending edits in Contacts before using a mutation, because Contacts' scripting save affects all pending changes.

Tools missing: check app-group/read-only settings, start a new session, and verify mcp get/mcp list in your client. Shortcut execution appears only with a nonempty allowlist. Apps need not be installed for their tools to be advertised.

`spawn ... ENOENT`: ensure Node and npx are accessible to the desktop client's PATH; use the fu

冒頭だけを表示しています。続きはリポジトリで読めます