Crawler Summary

applescript-mcp answer-first brief

MCP server for macOS AppleScript automation ๐ŸŽ AppleScript MCP Server Give Claude the power to control your Mac. This MCP server lets Claude automate applications, manage files, control music, send messages, and much more through AppleScript. What Can You Do With It? Once installed, just ask Claude things like: - **"What's playing right now?"** โ€” Claude checks Music.app and tells you - **"Create a reminder to call Mom tomorrow at 3pm"** โ€” Creates it in Reminde Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

Freshness

Last checked 2/22/2026

Best For

Contract is available with explicit auth and schema references.

Not Ideal For

applescript-mcp is not ideal for teams that need stronger public trust telemetry, lower setup complexity, or more explicit contract coverage before production rollout.

Evidence Sources Checked

editorial-content, capability-contract, runtime-metrics, public facts pack

Claim this agent
Agent DossierGitHubSafety: 100/100

applescript-mcp

MCP server for macOS AppleScript automation ๐ŸŽ AppleScript MCP Server Give Claude the power to control your Mac. This MCP server lets Claude automate applications, manage files, control music, send messages, and much more through AppleScript. What Can You Do With It? Once installed, just ask Claude things like: - **"What's playing right now?"** โ€” Claude checks Music.app and tells you - **"Create a reminder to call Mom tomorrow at 3pm"** โ€” Creates it in Reminde

MCPverified

Public facts

6

Change events

1

Artifacts

0

Freshness

Feb 22, 2026

Verifiededitorial-content1 verified compatibility signal

Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

Schema refs publishedTrust evidence available

Trust score

Unknown

Compatibility

MCP

Freshness

Feb 22, 2026

Vendor

Adamrdrew

Artifacts

0

Benchmarks

0

Last release

2.3.2

Executive Summary

Key links, install path, and a quick operational read before the deeper crawl record.

Verifiededitorial-content

Summary

Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

Setup snapshot

git clone https://github.com/adamrdrew/applescript-mcp.git
  1. 1

    Setup complexity is MEDIUM. Standard integration tests and API key provisioning are required before connecting this to production workloads.

  2. 2

    Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence Ledger

Everything public we have scraped or crawled about this agent, grouped by evidence type with provenance.

Verifiededitorial-content
Vendor (1)

Vendor

Adamrdrew

profilemedium
Observed Feb 24, 2026Source linkProvenance
Compatibility (2)

Protocol compatibility

MCP

contracthigh
Observed Feb 24, 2026Source linkProvenance

Auth modes

mcp, api_key

contracthigh
Observed Feb 24, 2026Source linkProvenance
Artifact (1)

Machine-readable schemas

OpenAPI or schema references published

contracthigh
Observed Feb 24, 2026Source linkProvenance
Security (1)

Handshake status

UNKNOWN

trustmedium
Observed unknownSource linkProvenance
Integration (1)

Crawlable docs

6 indexed pages on the official domain

search_documentmedium
Observed Apr 15, 2026Source linkProvenance

Release & Crawl Timeline

Merged public release, docs, artifact, benchmark, pricing, and trust refresh events.

Self-declaredagent-index

Artifacts Archive

Extracted files, examples, snippets, parameters, dependencies, permissions, and artifact metadata.

Self-declaredGITHUB MCP

Extracted files

0

Examples

6

Snippets

0

Languages

typescript

Executable Examples

bash

sdef /System/Applications/Notes.app | head -5

bash

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

text

/plugin marketplace add adamrdrew@marketplace
/plugin install applescript-mcp@adamrdrew

json

{
  "mcpServers": {
    "applescript-mcp": {
      "command": "npx",
      "args": ["-y", "applescript-mcp"]
    }
  }
}

json

{
  "permissions": {
    "allow": [
      "mcp__plugin_applescript-mcp_applescript-mcp-server__*"
    ]
  }
}

text

โŒ Automation permission denied for Safari.

HOW TO FIX:
1. Open System Settings
2. Go to Privacy & Security โ†’ Automation
3. Find your terminal app
4. Enable the toggle for "Safari"
5. Restart your terminal

Docs & README

Full documentation captured from public sources, including the complete README when available.

Self-declaredGITHUB MCP

Docs source

GITHUB MCP

Editorial quality

ready

MCP server for macOS AppleScript automation ๐ŸŽ AppleScript MCP Server Give Claude the power to control your Mac. This MCP server lets Claude automate applications, manage files, control music, send messages, and much more through AppleScript. What Can You Do With It? Once installed, just ask Claude things like: - **"What's playing right now?"** โ€” Claude checks Music.app and tells you - **"Create a reminder to call Mom tomorrow at 3pm"** โ€” Creates it in Reminde

Full README

๐ŸŽ AppleScript MCP Server

Give Claude the power to control your Mac. This MCP server lets Claude automate applications, manage files, control music, send messages, and much more through AppleScript.

What Can You Do With It?

Once installed, just ask Claude things like:

  • "What's playing right now?" โ€” Claude checks Music.app and tells you
  • "Create a reminder to call Mom tomorrow at 3pm" โ€” Creates it in Reminders
  • "Add a new note called 'Meeting Notes' with today's date" โ€” Creates it in Notes
  • "Open my Downloads folder" โ€” Opens it in Finder
  • "What apps are running?" โ€” Lists your active applications
  • "Play my Chill playlist" โ€” Starts playback in Music
  • "Get the URL of my current Safari tab" โ€” Returns the URL
  • "Create a new Calendar event for Friday at 2pm" โ€” Adds it to Calendar
  • "Show me what's on my clipboard" โ€” Displays clipboard contents
  • "Send a message to John saying I'm running late" โ€” Sends via Messages

Claude discovers what's possible, learns what works, and handles errors gracefully.

Requirements

  • macOS (AppleScript is macOS-only)
  • Node.js 18+ โ€” Download here
  • Xcode โ€” Install from the App Store (required for AppleScript dictionaries)

After installing Xcode, run this to verify it's set up correctly:

sdef /System/Applications/Notes.app | head -5

If you see XML output, you're good. If you get an error, run:

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

Installation

Claude Code

Install via the plugin marketplace:

/plugin marketplace add adamrdrew@marketplace
/plugin install applescript-mcp@adamrdrew

Restart Claude Code or run /mcp to verify it's connected.

Claude Desktop

Add this to your config file at ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "applescript-mcp": {
      "command": "npx",
      "args": ["-y", "applescript-mcp"]
    }
  }
}

Restart Claude Desktop.

Claude Code Permissions

Claude Code will ask you every time you use an MCP server command for the first time, meaning when you start using the MCP server you will get lots of "are you sure you want to do this?" prompts, which is a pretty terrible experience. After installing the plugin you can allowlist calls to the MCP server bu adding this to your .claude/settings.json

{
  "permissions": {
    "allow": [
      "mcp__plugin_applescript-mcp_applescript-mcp-server__*"
    ]
  }
}

System Permissions

The first time Claude tries to control an app, macOS will ask for permission. Grant these in System Settings โ†’ Privacy & Security:

| Permission | When It's Needed | |------------|------------------| | Automation | Controlling any app (Finder, Music, Safari, etc.) | | Accessibility | Keyboard simulation, UI automation | | Full Disk Access | Some file operations |

When prompted, allow your terminal app (Terminal, iTerm, Warp, etc.) or Claude Desktop to control the requested application.

What Apps Work?

Claude can control any "scriptable" macOS application. Most built-in apps are scriptable:

  • Finder โ€” File and folder operations
  • Music โ€” Playback, playlists, library access
  • Safari โ€” Tabs, URLs, reading lists
  • Mail โ€” Send, read, organize emails
  • Calendar โ€” Events and reminders
  • Notes โ€” Create and manage notes
  • Reminders โ€” Tasks and lists
  • Messages โ€” Send messages
  • Photos โ€” Albums and organization
  • Contacts โ€” Address book access
  • Keynote/Pages/Numbers โ€” Document automation
  • Terminal โ€” Script execution

Many third-party apps are also scriptable (Adobe apps, BBEdit, OmniFocus, etc.).

Safety Features

The server protects you from accidental damage:

| Risk Level | What Happens | Examples | |------------|--------------|----------| | Low | Runs normally | Get info, read data | | Medium | Warning shown | Sending emails, keystrokes | | High | Blocked until you confirm | Shell commands, quit all apps | | Critical | Blocked until you confirm | Delete all files, empty trash |

If Claude tries something risky, you'll see a warning and can decide whether to proceed.

Learning System

The server gets smarter over time:

  • Remembers what works โ€” Successful scripts are saved for future reference
  • Suggests fixes โ€” When something fails, it offers specific solutions
  • Skill files โ€” Curated examples for popular apps live in ~/.applescript-mcp/skills/

Helpful Error Messages

When something goes wrong, you get actionable fixes:

โŒ Automation permission denied for Safari.

HOW TO FIX:
1. Open System Settings
2. Go to Privacy & Security โ†’ Automation
3. Find your terminal app
4. Enable the toggle for "Safari"
5. Restart your terminal

Troubleshooting

"Xcode is not installed" Install Xcode from the App Store, then run:

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

"Permission denied" errors Open System Settings โ†’ Privacy & Security โ†’ Automation and enable the app.

Commands don't work on an app Not all apps are scriptable. Ask Claude to run list_scriptable_apps to see what's available.

Server not connecting

  • For Claude Code: Run /mcp to check status
  • For Claude Desktop: Restart the app after editing config

Contributing

Want to contribute, run from source, or understand the codebase? See CONTRIBUTING.md.

Want even deeper documentaiton? See the Project Documentation

License

This project is licensed under the GNU General Public License v3.0.

Contract & API

Machine endpoints, protocol fit, contract coverage, invocation examples, and guardrails for agent-to-agent use.

Verifiedcapability-contract

Contract coverage

Status

ready

Auth

mcp, api_key

Streaming

No

Data region

global

Protocol support

MCP: verified

Requires: mcp, lang:typescript

Forbidden: none

Guardrails

Operational confidence: medium

Contract is available with explicit auth and schema references.
Trust confidence is not low and verification freshness is acceptable.
Protocol support is explicitly confirmed in contract metadata.
Invocation examples
curl -s "https://xpersona.co/api/v1/agents/mcp-adamrdrew-applescript-mcp/snapshot"
curl -s "https://xpersona.co/api/v1/agents/mcp-adamrdrew-applescript-mcp/contract"
curl -s "https://xpersona.co/api/v1/agents/mcp-adamrdrew-applescript-mcp/trust"

Reliability & Benchmarks

Trust and runtime signals, benchmark suites, failure patterns, and practical risk constraints.

Missingruntime-metrics

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

No benchmark suites or observed failure patterns are available.

Media & Demo

Every public screenshot, visual asset, demo link, and owner-provided destination tied to this agent.

Missingno-media
No screenshots, media assets, or demo links are available.

Related Agents

Neighboring agents from the same protocol and source ecosystem for comparison and shortlist building.

Self-declaredprotocol-neighbors
GITLAB_AI_CATALOGgitlab-mcp

Rank

83

A Model Context Protocol (MCP) server for GitLab

Traction

No public download signal

Freshness

Updated 2d ago

MCP
GITLAB_PUBLIC_PROJECTSgitlab-mcp

Rank

80

A Model Context Protocol (MCP) server for GitLab

Traction

No public download signal

Freshness

Updated 2d ago

MCP
GITLAB_AI_CATALOGrmcp-openapi

Rank

74

Expose OpenAPI definition endpoints as MCP tools using the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)

Traction

No public download signal

Freshness

Updated 2d ago

MCP
GITLAB_AI_CATALOGrmcp-actix-web

Rank

72

An actix_web backend for the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)

Traction

No public download signal

Freshness

Updated 2d ago

MCP
Machine Appendix

Contract JSON

{
  "contractStatus": "ready",
  "authModes": [
    "mcp",
    "api_key"
  ],
  "requires": [
    "mcp",
    "lang:typescript"
  ],
  "forbidden": [],
  "supportsMcp": true,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": "https://github.com/adamrdrew/applescript-mcp#input",
  "outputSchemaRef": "https://github.com/adamrdrew/applescript-mcp#output",
  "dataRegion": "global",
  "contractUpdatedAt": "2026-02-24T19:45:16.874Z",
  "sourceUpdatedAt": "2026-02-24T19:45:16.874Z",
  "freshnessSeconds": 4433451
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://xpersona.co/api/v1/agents/mcp-adamrdrew-applescript-mcp/snapshot",
    "contractUrl": "https://xpersona.co/api/v1/agents/mcp-adamrdrew-applescript-mcp/contract",
    "trustUrl": "https://xpersona.co/api/v1/agents/mcp-adamrdrew-applescript-mcp/trust"
  },
  "curlExamples": [
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-adamrdrew-applescript-mcp/snapshot\"",
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-adamrdrew-applescript-mcp/contract\"",
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-adamrdrew-applescript-mcp/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "MCP"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "GITHUB_MCP",
      "generatedAt": "2026-04-17T03:16:07.934Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "MCP",
      "type": "protocol",
      "support": "supported",
      "confidenceSource": "contract",
      "notes": "Confirmed by capability contract"
    },
    {
      "key": "mcp",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "applescript",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "macos",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "automation",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "model-context-protocol",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "cli",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    }
  ],
  "flattenedTokens": "protocol:MCP|supported|contract capability:mcp|supported|profile capability:applescript|supported|profile capability:macos|supported|profile capability:automation|supported|profile capability:model-context-protocol|supported|profile capability:cli|supported|profile"
}

Facts JSON

[
  {
    "factKey": "docs_crawl",
    "category": "integration",
    "label": "Crawlable docs",
    "value": "6 indexed pages on the official domain",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "MCP",
    "href": "https://xpersona.co/api/v1/agents/mcp-adamrdrew-applescript-mcp/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-adamrdrew-applescript-mcp/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:45:16.874Z",
    "isPublic": true
  },
  {
    "factKey": "auth_modes",
    "category": "compatibility",
    "label": "Auth modes",
    "value": "mcp, api_key",
    "href": "https://xpersona.co/api/v1/agents/mcp-adamrdrew-applescript-mcp/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-adamrdrew-applescript-mcp/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:45:16.874Z",
    "isPublic": true
  },
  {
    "factKey": "schema_refs",
    "category": "artifact",
    "label": "Machine-readable schemas",
    "value": "OpenAPI or schema references published",
    "href": "https://github.com/adamrdrew/applescript-mcp#input",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-adamrdrew-applescript-mcp/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:45:16.874Z",
    "isPublic": true
  },
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Adamrdrew",
    "href": "https://github.com/adamrdrew/applescript-mcp",
    "sourceUrl": "https://github.com/adamrdrew/applescript-mcp",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-02-24T19:43:14.176Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://xpersona.co/api/v1/agents/mcp-adamrdrew-applescript-mcp/trust",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-adamrdrew-applescript-mcp/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "docs_update",
    "title": "Docs refreshed: Sign in to GitHub ยท GitHub",
    "description": "Fresh crawlable documentation was indexed for the official domain.",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  }
]

Sponsored

Ads related to applescript-mcp and adjacent AI workflows.