mcp-server-macos-use
@mediar-ai
About mcp-server-macos-use
AI agent that controls computer with OS-level tools, MCP compatible, works with any model
Basic information
Config
No standard config provided
This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.
RepositoryTools
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
FAQ from mcp-server-macos-use
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.
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 ([email protected]) or Discord (m13v_). The maintainer is open to tailoring the server for specific needs.
More Productivity MCP servers
MCP SAP GUI Server
mario-andreschakMCP server that allows simple SAP GUI interaction for LLM models using simulated mouse clicks and keyboard input.
ntfy-mcp: Your Friendly Task Completion Notifier
teddyzxcv
MCP Shrimp Task Manager
cjo4m06Shrimp Task Manager is a task tool built for AI Agents, emphasizing chain-of-thought, reflection, and style consistency. It converts natural language into structured dev tasks with dependency tracking and iterative refinement, enabling agent-like developer behavior in reasoning A
Task Manager MCP Server
tradesdontlieA task management MCP server that provides comprehensive project and task tracking capabilities
Todo List MCP Server
RegiByteAn MCP server for managing todos within LLMs, created for educational purposes
Comments