What does mcp-server-macos-use do?
It exposes MCP tools that let you open apps, click, type, and press keys, then traverse the accessibility tree—allowing programmatic control of macOS apps from an MCP client.
MCP Server Macos Use
@mediar-ai
Basic information
About MCP Server Macos Use
AI agent that controls computer with OS-level tools, MCP compatible, works with any model
MCP Server Macos Use config
No standard config provided
This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.
RepositoryMCP Server Macos Use tools
10** Opens or activates a specified application and then traverses its accessibility tree.
`identifier` (String, Required): The application's name, bundle ID, or file path.
** Simulates a mouse click at specific coordinates within the window of the target application (identified by PID) and then traverses its accessibility tree.
`pid` (Number, Required): The Process ID (PID) of the target application.
** Simulates typing text into the target application (identified by PID) and then traverses its accessibility tree.
`pid` (Number, Required): The Process ID (PID) of the target application.
** Simulates pressing a specific keyboard key (e.g., 'Enter', 'Tab', 'a', 'B') with optional modifier keys held down, targeting the application specified by PID, and then traverses its accessibility tree.
`pid` (Number, Required): The Process ID (PID) of the target application.
** Only performs the accessibility tree traversal for the specified application (identified by PID). Useful for getting the current UI state without performing an action.
`pid` (Number, Required): The Process ID (PID) of the application to traverse.
Overview
What is mcp-server-macos-use?
An MCP server in Swift that controls macOS applications via accessibility APIs through the MacosUseSDK. It is designed for users of MCP-compatible clients like Claude Desktop who need to automate or interact with desktop apps programmatically.
How to use mcp-server-macos-use?
Build the server with swift build -c debug, then run the executable. It communicates over standard input/output (stdio). Configure your MCP client (e.g., Claude Desktop) by pointing it to the server binary path in the client's configuration file.
Key features of mcp-server-macos-use
- Open or activate an application and traverse its accessibility tree
- Simulate mouse clicks at specified coordinates
- Simulate typing text into a target application
- Press keyboard keys with optional modifier flags
- Refresh traversal to get current UI state without action
- Control traversal behavior with optional parameters (diff, visibility, animation, delay)
Use cases of mcp-server-macos-use
- Automating repetitive UI tasks in any macOS application
- Querying the current UI state of a running desktop app
- Building AI-powered assistants that interact with native macOS software
- Accessibility tree inspection and testing
Frequently asked questions
What dependencies does mcp-server-macos-use require?
It requires the MacosUseSDK Swift package and Swift toolchain to build. No other runtime dependencies are listed.
How does mcp-server-macos-use communicate?
It uses the stdio transport: the server reads and writes MCP messages over standard input and output.
How do I integrate mcp-server-macos-use with Claude Desktop?
Add an entry to Claude Desktop's configuration with the command set to the absolute path of the built server executable, under the `mcpServers` key.
Where can I get help or request features?
Reach out via email (matt@mediar.ai) or Discord (m13v_). The maintainer is open to tailoring the server for specific needs.
More Productivity MCP servers
systemHUB
David JenynsSOP software for small and medium businesses. Connect Claude, ChatGPT or any MCP-capable AI to search, draft, update and publish SOPs, policies and trainings in your systemHUB account. OAuth sign-in. Included on Accelera
Dadan MCP
Dadan-iodadan-sdk-integration is an SDK for integrating Dadan features into React applications. It allows you to add video recording and file selection functionality directly into your React components, providing a seamless user
FlowyTeam OKR MCP Server
flowy-teamFlowyTeam 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,
WhatsApp MCP
Bernardo RuzWhatsApp MCP connects your AI assistant to the WhatsApp number you already use. Ask Claude, ChatGPT, Cursor or any MCP client who's waiting for a reply, summarize a group, find an old message, or send and schedule messag
crosscode-cli
amsultan2010Multiplayer coding in the agentic era through an MCP server for real-time codebase sync between your agents.
1
Comments