Moom MCP Server

What is Moom MCP Server?

A Model Context Protocol server that enables programmatic control of Moom window layouts on macOS through natural language commands in Claude Desktop. It allows switching layouts, saving arrangements, executing window actions, and includes optional DisplayPlacer integration for pixel‑perfect multi‑monitor positioning.

How to use Moom MCP Server?

Install the server by cloning the repository, running npm install, granting accessibility permissions in System Preferences for Terminal and Claude Desktop, and adding the server configuration to Claude Desktop’s claude_desktop_config.json. After restarting Claude, you can issue natural language commands such as “Switch to my Teaching (Mac Mini) layout” or “Save the current window arrangement as 'Focus Mode'”.

Key features of Moom MCP Server

• activate_layout – switch to any saved Moom layout instantly
• save_current_layout – save current window arrangement as a reusable layout
• trigger_moom_action – execute window actions (grow, shrink, move, center, fill‑screen)
• show_moom_menu – display the Moom popup menu
• DisplayPlacer integration for pixel‑perfect multi‑monitor positioning
• Precision coordinate‑based window management

Use cases of Moom MCP Server

• Switch between dedicated work, teaching, or coding layouts with a single voice or text command
• Save a current window arrangement as a reusable layout for quick recall later
• Resize, center, or move windows using natural language (“make this window bigger”, “move window to the left”)
• Create pixel‑perfect multi‑monitor layouts using DisplayPlacer exact coordinates

FAQ from Moom MCP Server

What are the prerequisites?

macOS 10.12 or later, Moom installed and running, Node.js 14+, Claude Desktop app, and a terminal app with accessibility permissions. DisplayPlacer is optional but recommended for enhanced multi‑monitor support.

Why can’t I activate a layout?

Layout names are case‑sensitive. Verify the exact name in Moom preferences and escape special characters if needed.

How do I fix “Error accessing Moom menu”?

Ensure Moom is running, verify that both Terminal and Claude Desktop have accessibility permissions in System Preferences, and check that Moom’s menu bar icon is visible.

Why isn’t MCP loading in Claude Desktop?

Restart Claude Desktop after configuration changes, ensure the config file uses an absolute path, and verify that Node.js is in your PATH.