Moom MCP Server

Name: Moom MCP Server
Author: itrimble

@itrimble

Repository

About Moom MCP Server

MCP server for controlling Moom window layouts on macOS through Claude Desktop

#moom #mcp #window-management

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "moom": {
      "command": "node",
      "args": [
        "/absolute/path/to/moom-mcp/src/index.js"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.