Advertise
MCP.so
Sign In

AppleScript MCP Server (Dual access: python and node.js)

@peakmojo

Repository

Basic information

Category

Productivity

Last updated

License

MIT

Transports

stdio

Author

peakmojo

About AppleScript MCP Server

MCP server that execute applescript giving you full control of your Mac

#macos#applescript#mcp#mcp-server

AppleScript MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "applescript-mcp": {
      "command": "uv",
      "args": [
        "sync",
        "--dev"
      ]
    }
  }
}

AppleScript MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is AppleScript MCP Server (Dual access: python and node.js)?

A Model Context Protocol (MCP) server that lets you run AppleScript code to interact with a Mac. It is designed to be simple, straightforward, and require minimal setup, providing dual access via either Python or Node.js.

How to use AppleScript MCP Server (Dual access: python and node.js)?

Install and run the server using npx for Node.js, or uvx (from the git repo) or uv (local development) for Python. Configure your MCP client (e.g., Claude Desktop) with the appropriate command and arguments as shown in the README.

Key features of AppleScript MCP Server (Dual access: python and node.js)

  • 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

Use cases of AppleScript MCP Server (Dual access: python and node.js)

  • Automate reminders, calendar events, and note creation on a Mac
  • Retrieve system information like battery level or free disk space
  • Control applications: play music, take screenshots, open Safari
  • Manage files: create folders, find recent downloads, read and write files
  • Access and search contacts, emails, and running applications

Frequently asked questions

1

What runtime dependencies are required?

Node.js (for the npx command) or Python with `uv` installed (for the uvx or local setup). Optionally, SSH must be enabled on the Mac for remote execution.

2

How do I configure the server for Docker usage?

Use the npx command with `--remoteHost`, `--remoteUser`, and `--remotePassword` arguments. Ensure SSH is enabled on the Mac host and proper credentials are provided.

3

How do I run AppleScript remotely?

Use the remote execution feature via SSH by passing the SSH hostname, username, and password or key. The server can then execute AppleScript on a machine at the given address.

4

Can I use this server without cloning the repository?

Yes. For Python, you can run directly with `uvx --from git+https://github.com/peakmojo/applescript-mcp mcp-server-applescript`. For Node.js, use `npx @peakmojo/applescript-mcp`.

5

Are there any known limitations or security considerations?

The server executes arbitrary AppleScript and shell commands on the Mac. Use caution when granting it access, especially when using remote SSH execution.

Comments

More Productivity MCP servers

Common Paper Contracts

Common Paper, Inc.

Common Paper is a contract platform for revenue and legal teams. Create templates, customize contracts, negotiate terms with counterparties, collect signatures, and kick off billing - all from one workflow. Ask what's

FlowyTeam OKR MCP Server

flowy-team

FlowyTeam is a native OKR MCP server. Connect Claude (Desktop, web, mobile), ChatGPT, Claude Code or n8n and your agent can read every objective and key result in your workspace, post check-ins, move key-result progress,

ZenSched

ZenShows LLC

Field workforce scheduling for AI agents. Connect over MCP for account create, verified GPS punches, worker invites, shifts, forms, webhooks, and timesheets — no human dashboard. MCP: https://mcp.zensched.com/mcp Site: h

WhatsMCP

whatsmcp

WhatsMCP — WhatsApp for AI agents. Put an AI agent on a real WhatsApp number. Expose regular WhatsApp accounts to your LLM agents over JSON-RPC. A complete Model Context Protocol server that turns phone numbers into addr

assign2me.com

Trogon

Official MCP server for assign2me.com, a task management app for IT teams and their clients. Assign2me is lightweight, intuitive software that lets you use Connect Claude, Claude Code, ChatGPT, or other MCP-compatible as

Advertise