AppleScript BB MCP Server

What can you do with AppleScript BB MCP?

- Execute AppleScript— Run AppleScript code directly from AI conversations to control macOS apps and automate tasks.
- Read app dictionaries— Discover what AppleScript commands and objects an application supports via its dictionary.
- Automate Finder— Manage files, set labels, retrieve selections, and organize the file system through Finder integration.
- Manage automation permissions— Check and manage AppleScript automation access for the server.

Build enterprise-grade MCP servers with our battle-tested, open-source library. Extracted from production systems and designed for real-world use.

MCP is an open protocol that enables AI applications to securely connect to data sources and tools. Think of it as a universal connector for AI systems.

Connect any AI application to your business tools and data sources using a standardized protocol.

Build once, use with any MCP-compatible AI application as the ecosystem grows.

Built-in security features protect your data while enabling powerful integrations.

Leverage existing libraries and patterns to quickly build custom integrations.

BB MCP Server: Production-Ready MCP Library

A comprehensive Deno-based framework for building enterprise-grade MCP servers

- Rapid Development:Plugin system with automatic discovery gets you productive immediately
- Enterprise-Ready:Built-in OAuth, dual transport support, and persistent storage for production deployments
- Type-Safe:Full TypeScript support with strict validation reduces bugs and improves maintainability
- Battle-Tested:Extracted from production MCP servers serving real businesses

- ✓Plugin system with automatic discovery and loading
- ✓OAuth provider and consumer for third-party integrations
- ✓STDIO and HTTP transport with session management
- ✓Deno KV-based storage with automatic cleanup and chunking
- ✓Comprehensive logging with audit trails and structured output
- ✓Full TypeScript with strict type checking
- ✓Extensive test utilities and examples
- ✓Published on JSR registry for easy installation

The library includes 4 progressive examples that teach you everything from basic tools to advanced OAuth integration:

Basic setup with utility tools and plugin discovery

Multi-step workflows for complex business logic

Third-party API integration with authentication

Complete infrastructure control for advanced use cases

A comprehensive testing platform for MCP client implementations

While the MCP Inspector exists as an MCP client for testing servers, this tool fills the inverse need - an MCP server for testing clients. The BB MCP Client Inspector provides an interactive web console for testing and validating MCP client implementations.

- 🔍 Protocol Message Inspection - View all MCP JSON-RPC messages in real-time
- 🧠 Sampling Testing - Test client LLM completion capabilities
- ❓ Elicitation Testing - Test client user input request handling
- 🔔 Notification Testing - Trigger and verify list change notifications
- 🛠️ Inspector Tools - Six utility tools for testing scenarios
- 📊 Multi-Client Support - Test multiple clients simultaneously (HTTP mode)
- 🌐 Web Console - Interactive Fresh UI for testing

Run directly from JSR - no installation required:

deno run -A jsr:@beyondbetter/bb-mcp-client-inspector

This starts the MCP server on port 3000 and the web UI on port 8000.

Validate your MCP client implementation by testing sampling, elicitation, and notification handling in a controlled environment.

Inspect all JSON-RPC messages in real-time to debug communication issues between clients and servers.

Test multiple clients simultaneously in HTTP mode to verify consistent behavior across different implementations.

Six utility tools for comprehensive testing:

- ✓echo- Message echoing with optional delay and transformation
- ✓convert_date- Date/timezone conversion and formatting
- ✓calculate- Basic arithmetic operations
- ✓delay_response- Configurable delays for timeout testing
- ✓random_data- Generate random test data
- ✓trigger_error- Intentionally trigger errors for error handling tests

Extend macOS workflows with AppleScript automation through MCP

A production-ready MCP server that brings AppleScript automation to any MCP-compatible AI application. Built using BB MCP Server as a real-world example of what you can create with the library.

- Execute AppleScript code from AI conversations
- Read application dictionaries to discover capabilities
- Automate file management with Finder integration
- Manage permissions and check automation access

Add this to your Claude Desktop configuration:

{ "mcpServers": { "bb-applescript": { "command": "deno", "args": [ "run", "--allow-all", "--unstable-kv", "jsr:@beyondbetter/bb-applescript-mcp-server" ] } } }

Automate BBEdit projects, manipulate files, and integrate with development tools through AI conversations.

Organize files, set labels, retrieve selections, and manage your file system with natural language.

Control macOS applications that support AppleScript through your AI assistant.

Use our open-source library to get started today, or talk to us about a custom solution built for your business.

On-device tools to detect AI-generated text and images, score readability, and strip AI artifacts, running locally on Apple silicon.

Interact with Apple Notes using natural language on macOS.

Free local MCP server for Apple Mail, Calendar, and Reminders on macOS.

A server for native integration with Apple Reminders on macOS.

Execute AppleScript to gain full control of your Mac.

Native macOS Calendar & Reminders MCP server with 24 tools using Swift EventKit - supports recurring events, location triggers, search, batch operations

Native macOS Calendar & Reminders MCP server via Apple EventKit — events, reminders, recurrence, location triggers, conflict checks, and batch ops across iCloud/Google/Exchange.

An MCP server for integrating with the Claude Desktop application on macOS. Requires the Claude Desktop app to be installed and configured.

Read-only MCP endpoint for a managed dedicated Mac mini AI operator setup service with public pricing and a 10-founder-install queue.