AppleScript MCPサーバー
AIクライアントからMac上でAppleScriptを実行し、アプリ、ファイル、リマインダー、カレンダー、メッセージ、シェルコマンドを制御できます。
別名 peakmojo/applescript-mcp, @peakmojo/applescript-mcp
- スター
- 468
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年2月22日
- ライセンス
- MIT
AppleScript MCPとは
AppleScriptはMCPサーバーです。 AIクライアントからMac上でAppleScriptを実行し、アプリ、ファイル、リマインダー、カレンダー、メッセージ、シェルコマンドを制御できます。.
プロジェクトのREADMEから生成された概要
AppleScript MCP server について
このMCP serverを使用すると、AIクライアントを通じてmacOSのアプリケーションやシステムデータを制御できます。AppleScriptを実行することで、チャットインターフェースから直接、ファイル、リマインダー、カレンダー、メッセージ、メモの管理が可能になります。言語モデルとMac OSの架け橋となることで、Apple Music、Safari、連絡先などのネイティブアプリとの自動的なやり取りを実現します。
開発者は、Node.jsのnpx、またはPythonのuvxを使用してローカル環境にセットアップできます。Dockerコンテナ内で作業している場合は、ホストマシンに接続するSSH経由のリモート実行をサポートしています。このセットアップには、Macのシステム設定で「リモートログイン」を有効にし、必要なユーザー認証情報を提供する必要があります。このサーバーを利用することで、バッテリー残量の確認、Spotlightによるファイル検索、シェルコマンドの実行といったシステムタスクを実行できます。
できること
- 1個人のスケジュールやタスクの管理AIに対して、カレンダーに新しい会議を追加したり、特定のリマインダーを作成したりするよう指示できます。
- 2ローカルファイルの整理と検索AIに、フォルダ内の特定のファイルを探したり、デスクトップに新しいディレクトリを作成したりするよう依頼できます。
- 3メディアとシステム設定の制御AIに、特定のミュージックプレイリストを再生させたり、ハードウェアの状態を確認させたりできます。
- 4コミュニケーションと連絡先の取得の自動化AIを使用して、連絡先から電話番号を見つけたり、未読メッセージを確認したりできます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
AppleScript MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにAppleScript MCPをインストール
$ claude mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcpCursorにAppleScript MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}VS CodeにAppleScript MCPをインストール
.vscode/mcp.json
{
"servers": {
"applescript-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}VS Code CLIにAppleScript MCPをインストール
$ code --add-mcp '{"name":"applescript-mcp","type":"stdio","command":"npx","args":["-y","@peakmojo/applescript-mcp"]}'Claude DesktopにAppleScript MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}CodexにAppleScript MCPをインストール
$ codex mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcpCodex config.tomlにAppleScript MCPをインストール
~/.codex/config.toml
[mcp_servers.applescript-mcp] command = "npx" args = ["-y", "@peakmojo/applescript-mcp"]
Gemini CLIにAppleScript MCPをインストール
$ gemini mcp add -s user applescript-mcp npx -- -y @peakmojo/applescript-mcpGemini settings.jsonにAppleScript MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能peakmojo/applescript-mcp is public and reachablegithub.com/peakmojo/applescript-mcp ↗合格
- パッケージがこのリポジトリをソースとして指定@peakmojo/applescript-mcp names peakmojo/applescript-mcp as sourcenpmjs.com/package/@peakmojo/applescript-mcp ↗合格
- ビルドの来歴 (Sigstore 証明)No build attestation published for this release未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-02-22github.com/peakmojo/applescript-mcp ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from @peakmojo/applescript-mcp合格
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るAppleScript MCP Server (Dual access: python and node.js)
Overview
A Model Context Protocol (MCP) server that lets you run AppleScript code to interact with Mac. This MCP is intentionally designed to be simple, straightforward, intuitive, and require minimal setup.
I can't believe how simple and powerful it is. The core code is <100 line of code.
https://github.com/user-attachments/assets/b85e63ba-fb26-4918-8e6d-2377254ee388
Features
- Run AppleScript to access Mac applications and data
- Interact with Notes, Calendar, Contacts, Messages, and more
- Search for files using Spotlight or Finder
- Read/write file contents and execute shell commands
- Remote execution support via SSH
Example Prompts
Create a reminder for me to call John tomorrow at 10am
Add a new meeting to my calendar for Friday from 2-3pm titled "Team Review"
Create a new note titled "Meeting Minutes" with today's date
Show me all files in my Downloads folder from the past week
What's my current battery percentage?
Show me the most recent unread emails in my inbox
List all the currently running applications on my Mac
Play my "Focus" playlist in Apple Music
Take a screenshot of my entire screen and save it to my Desktop
Find John Smith in my contacts and show me his phone number
Create a folder on my Desktop named "Project Files"
Open Safari and navigate to apple.com
Tell me how much free space I have on my main drive
List all my upcoming calendar events for this week
Usage with Claude Desktop
Node.js
{
"mcpServers": {
"applescript_execute": {
"command": "npx",
"args": [
"@peakmojo/applescript-mcp"
]
}
}
}
Python (uvx)
No clone needed — run directly from the git repo:
{
"mcpServers": {
"applescript_execute": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/peakmojo/applescript-mcp",
"mcp-server-applescript"
]
}
}
}
Python (local development)
For local development, clone the repo and use uv to run from source:
brew install uv
git clone https://github.com/peakmojo/applescript-mcp.git
{
"mcpServers": {
"applescript_execute": {
"command": "uv",
"args": [
"--directory",
"/path/to/your/repo",
"run",
"mcp-server-applescript"
]
}
}
}
Development
Setup
brew install uv
uv sync --dev
Run all checks (in parallel)
uv run check
This runs linting, formatting, type checking, and tests with 100% coverage — all in parallel.
Individual commands
uv run lint # ruff linter
uv run format # ruff auto-format
uv run typecheck # pyrefly type checker
uv run test # pytest with 100% coverage enforcement
Docker Usage
When running in a Docker container, you can use the special hostname host.docker.internal to connect to your Mac host:
Configuration
{
"mcpServers": {
"applescript_execute": {
"command": "npx",
"args": [
"@peakmojo/applescript-mcp",
"--remoteHost", "host.docker.internal",
"--remoteUser", "yourusername",
"--remotePassword", "yourpassword"
]
}
}
}
This allows your Docker container to execute AppleScript on the Mac host system. Make sure:
- SSH is enabled on your Mac (System Settings → Sharing → Remote Login)
- Your user has proper permissions
- The correct credentials are provided in the config
AppleScript MCPのよくある質問
AppleScript MCPをClaude Codeに追加するには
ターミナルでclaude mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
AppleScript MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Mac上のAppleScript MCP serverで何ができますか?
AppleScriptを実行して、メモ、カレンダー、連絡先、メッセージ、ファイル、シェルコマンドなどのMacアプリケーションやデータと連携できます。
Claude DesktopにAppleScript MCP serverをインストールするにはどうすればよいですか?
npxを使用してパッケージ @peakmojo/applescript-mcp をMCP serverとして追加するか、gitリポジトリからuvxを使用してPython版を実行してください。
Dockerコンテナ内から動作させることはできますか?
はい、Mac側でSSHを有効にした上で、host.docker.internal というホスト名に加えて、リモートホスト、ユーザー、パスワードの引数を使用することで可能です。
リモート実行はサポートされていますか?
はい、リモートホスト、ユーザー、パスワードを指定することで、SSH経由のリモート実行がサポートされています。
Python版の実行にはどのコマンドラインツールが必要ですか?
Python版はuv経由で実行されます。uvはHomebrewでインストール可能です。