Moom

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

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can control Moom window layouts on macOS through Claude Desktop with a dedicated MCP server. This setup lets you activate saved layouts, save new ones, perform precise window actions, access the Moom menu, and leverage pixel-perfect multi-monitor positioning with DisplayPlacer when needed.

How to use

You operate this MCP server from an MCP client, sending structured commands that map to Moom actions. Use natural language or explicit actions to switch layouts, save current arrangements, or trigger window actions. When DisplayPlacer is available, you can achieve pixel-perfect placements across multiple monitors and work with precise coordinates.

How to install

Prerequisites include macOS 10.12 or later, Moom installed and running, Node.js 14 or higher, Claude Desktop, and a Terminal app with accessibility permissions.

Step 1: Clone the MCP server repository and open it in a terminal.

Step 2: Install dependencies.

Step 3: Grant accessibility permissions for Terminal and Claude Desktop.

Step 4: Add the MCP server to Claude Desktop configuration.

Step 5: Restart Claude Desktop to apply changes.

# Step 1: Clone the MCP server
git clone https://github.com/itrimble/moom-mcp.git
cd moom-mcp

# Step 2: Install dependencies
npm install

# Step 3: Grant accessibility permissions via System Settings (done manually by you)

# Step 4: Configure Claude Desktop to load the MCP server (example snippet to place in Claude config)

MCP server configuration for Claude Desktop

Configure Claude Desktop to load the MCP server by pointing to the local startup script. Use the following JSON structure in your Claude Desktop configuration.

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

Available tools

activate_layout

Switch to a saved Moom layout instantly by specifying the layout name.

save_current_layout

Save the current window arrangement as a reusable layout with a chosen name.

trigger_moom_action

Execute a Moom action such as move, resize, center, grow, shrink, or fill-screen on the active window.

show_moom_menu

Display the Moom popup menu to select layouts or actions.

displayplacer_integration

Utilize DisplayPlacer for pixel-perfect multi-monitor positioning and advanced multi-monitor layouts.

precision_layouts

Define layouts using exact coordinates for precise window placements across monitors.