macuse

Macuse — あらゆる Mac アプリに AI の力を

Model Context Protocol を介して、AI がカレンダー、メール、メモ、リマインダー、メッセージなど、あらゆる Mac アプリを直接操作できるようにします。macOS 向けの MCP サーバーとコンピューター操作機能を組み合わせ、すべてデバイス上で実行します。

Claude Desktop、Cursor、Codex、Raycast、VS Code、Warp、Zed、LM Studio、Windsurf、およびあらゆる MCP 互換クライアントで動作します。

このリポジトリでは、エージェントクライアント向けに Macuse をパッケージ化しています。Claude Desktop 用 .mcpb インストーラーと、Claude Code および Codex 用のエージェントプラグインを提供します。macOS アプリ本体とドキュメント全文は macuse.app にあります。

利用するもの	インストールするもの	利用できる機能
Claude Code、Codex	エージェントプラグイン	MCP ツールとスキル
Claude Desktop	.mcpb バンドル	MCP ツール
Cursor、Raycast、VS Code、Zed、…	直接コマンド	MCP ツール

3 つとも同じローカルサーバーに接続します。プラグインにはスキルもインストールされます。スキルは、エージェントがパラメーターの形式を試行錯誤して調べるのではなく、ツールを正しく使えるように手順を教えます。

Macuse でできること

AI が Mac を操作する、相互に補完し合う 2 つの方法です。すべてローカルで動作し、データがデバイスの外に出ることはありません。

ネイティブアプリ連携

自然な会話を通じて、AI が macOS アプリのデータを直接読み書きします。

ツールボックス	依頼できること
カレンダー	「来週火曜日の午後 3 時に会議を設定して」、空き時間の検索、イベントの管理
メール	「このメールへの返信を下書きして」、受信トレイの検索、メッセージの整理
メモ	「第 2 四半期のローンチについて書かれたメモを探して」、アイデアの記録、メモへの追記
リマインダー	期限と優先度を指定したタスクの作成、完了のマーク付け、リストの横断検索
メッセージ	iMessage の読み取りと送信、会話の検索
スティッキーズ	Apple スティッキーズの付箋の検索、読み取り、作成
連絡先	名前、メールアドレス、電話番号、または会社名で検索
マップと位置情報	場所の検索、経路、移動時間、現在地
ショートカット	インストール済みのショートカットの一覧表示と、任意の入力を指定した実行

macOS でのコンピューター操作

専用の連携機能がないアプリも含め、あらゆる Mac アプリを表示して操作できます。Macuse は Claude や Codex に限らず、あらゆる MCP クライアントで使える、macOS 向けのコンピューター操作機能を提供します。

• あらゆる要素をクリックし、テキストを入力し、メニューを操作して、どのアプリでも使えます
• Web フォームの入力、エンタープライズソフトウェアの操作、既存の API がない作業の自動化ができます
• バックグラウンドで実行されるため、AI が別のアプリで作業している間も、カーソルとアクティブウィンドウはそのままです

エージェントプラグインとしてインストールする

Claude Code と Codex 向けです。MCP サーバーと 3 つのスキルがバンドルされているため、エージェントはワークフロー、パラメーター形式、権限エラーからの復旧方法をあらかじめ把握できます。

1. Macuse をインストールします： macuse.app/download からダウンロードし、Macuse.app を /Applications にドラッグして、一度起動します

2. マーケットプレイスを追加してインストールします：

   Claude Code

   /plugin marketplace add macuse-app/macuse-mcp
   /plugin install macuse@macuse-plugins
   

   Codex

   codex plugin marketplace add macuse-app/macuse-mcp
   codex plugin add macuse@macuse-plugins
   

3. OAuth を承認します： 初めてツールを呼び出すときに、Macuse のウィンドウに表示される認証プロンプトを承認します

ツールがすぐに表示されない場合は、セッションを再起動するか、Claude Code で /reload-plugins を実行してください。アプリが /Applications にない場合は、MACUSE_BINARY を設定してください。

含まれるスキル

スキル	対応範囲
macuse-setup	インストール、クライアントの接続、macOS の権限付与、セットアップの問題の診断
macuse-apps	カレンダー、メール、リマインダー、メモ、メッセージ、位置情報 — ルーティング、パラメーターの形式、ワークフローの順序
macuse-computer-use	あらゆる Mac アプリの GUI 操作 — 確認・操作・検証の繰り返し、要素の指定、エラーからの復旧

エージェントは、タスクで必要な場合にのみスキルを読み込みます。詳細は plugins/macuse/README.mdをご覧ください。

Codex ユーザー向け： Codex がサードパーティ製 MCP サーバーからの 同意プロンプトを自動的に拒否するため、現在、書き込み操作は失敗します （openai/codex#18896）。読み取りは 通常どおり動作します。

Claude Desktop にインストール

Claude Desktop はリモートの http:// コネクターを直接サポートしていないため、この .mcpb がワンクリックインストーラーになります。他の MCP クライアントについては、以下の他の MCP クライアントでの使用をご覧ください。

1. Macuse をインストール：
   • macuse.app/downloadからダウンロードします
   • Macuse.appを/Applicationsにドラッグして起動します
   • アプリの指示に従って権限を付与します
2. バンドルをインストール： Releasesからmacuse.mcpbをダウンロードし、ダブルクリックして Claude Desktop で開きます
3. OAuth を承認： 表示される認証プロンプトを承認すれば、接続は完了です

アンインストールするには、Claude Desktop の設定からエントリーを削除します。

他の MCP クライアントでの使用

カスタムコマンドを受け付けるクライアント（Cursor、Codex、Raycast、VS Code、Warp、Zed、LM Studio、Windsurf、ChatWise など）では、このバンドルを使わず、直接設定してください。

{
  "mcpServers": {
    "macuse": {
      "command": "/Applications/Macuse.app/Contents/MacOS/macuse",
      "args": ["mcp"]
    }
  }
}

クライアントごとのセットアップガイド：macuse.app/docs/clients。

プライバシーと権限

• ローカルのみ。 すべての処理はお使いの Mac 上で行われます。クラウドへの送信はなく、コンテンツのテレメトリーもありません。
• アプリごとの権限。 各 AI クライアントがアクセスする各アプリについて、許可、拒否、または一度だけ承認できます。パスワードマネージャーや銀行アプリなどの機密性の高いアプリでは、毎回再確認が求められます。AI クライアントを取り消すと、そのアプリに対する権限も自動的にクリアされます。
• クライアントごとの OAuth。 各 MCP クライアントには個別の認証が割り当てられ、Macuse の設定から管理できます。

仕組み

どのインストール方法も、同じ機能である macuse mcp を呼び出す薄いラッパーです。これは Macuse macOS アプリに組み込まれた CLI です。MCP プロトコルの処理、OAuth、権限、再接続はすべてアプリ内で行われます。

• .mcpb バンドルは、macuse mcpを起動し、標準入力／標準出力経由で JSON-RPC を転送する、約 130 行の Node 標準入出力ラッパーです。Claude Desktop がリモートの http:// コネクターをまだ直接サポートしていないためだけに用意されています。
• プラグインは Node を完全に省略します。シェルランチャーが同じバイナリを実行し、スキルを追加します。

MACUSE_BINARY環境変数でバイナリのパスを上書きできます （Claude Desktop バンドルの UI で設定可能）。デフォルト： /Applications/Macuse.app/Contents/MacOS/macuse。

リポジトリの構成

.claude-plugin/marketplace.json   Claude Code marketplace catalog
.agents/plugins/marketplace.json  Codex marketplace catalog
plugins/macuse/                   The plugin — manifests, launcher, skills
src/, bin/                        Node stdio wrapper for the .mcpb bundle
manifest.json                     .mcpb bundle manifest (Claude Desktop)
server.json                       MCP Registry entry

両方のマーケットプレイスは、このリポジトリのplugins/macuseを参照するため、1 回のプッシュで すべての配布先が更新されます。package.json、manifest.json、および両方の プラグインマニフェストのバージョン文字列は、リリース時に scripts/sync-manifest-version.jsによって同期されます。

プッシュする前にプラグインの変更を検証してください。

claude plugin validate ./plugins/macuse --strict   # plugin manifest
claude plugin validate . --strict                  # marketplace catalog

要件

• macOS 13.0（Ventura）以降 — Apple Silicon または Intel
• Macuse macOS アプリがインストールされていること
• .mcpb バンドルのみ Node 20.8.1 以降（Claude Desktop のランタイムに同梱）。プラグインには Node の依存関係はありません

リンク

• ウェブサイト：macuse.app
• ダウンロード：macuse.app/download
• ドキュメント：macuse.app/docs
• 料金：macuse.app/pricing — 1 日あたりの制限付き無料プラン、または一度限りの Lifetime
• MCP 仕様：modelcontextprotocol.io

ライセンス

この MCPB バンドルは MIT ライセンスです。Macuse macOS アプリケーションは別個の商用製品です。詳細は macuse.app をご覧ください。