# Spacepal

> Spacepal is an MCP server for productivity. Name, list and switch macOS Spaces from Claude or Cursor, locally. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** macOS, CLI
- **Website:** https://getspacepal.com/integrations/mcp/
- **MCP Registry name:** com.getspacepal/spacepal
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

A stdio server that runs on your Mac and makes no network calls. It reads Spacepal's state.json file for the list of Spaces and performs every action through spacepal:// links, so the Spacepal app must be running; otherwise each tool answers that Spacepal is not running.

Twenty tools go beyond switching. An agent can see which apps sit on each desktop, rename a desktop, attach a note, move the frontmost window, open a URL on a chosen Space, apply saved profiles or starter templates (Developer, Designer, Freelancer, Student, Streamer), save and restore window layouts and terminal or Chrome sessions, and hide names for screen shares. Tools carry MCP hints, so clients can ask before remove_desktop or apply_template.

It needs macOS 14 or later and Node.js 18 or later, and the server is free and MIT-licensed. The app itself is a one-time purchase with a 14-day trial, and after the trial the overview and saved sessions need a licence. A caveat: moving a window acts on the frontmost one, which in Claude Desktop is usually Claude's own window.

## Features

- **Space listing:** Shows every Space with number, name, display, apps and notes.
- **Switching and renaming:** Switches by number, name or step, and names desktops.
- **Window moves:** Moves or places the front window, including halves and quarters.
- **Profiles and templates:** Applies saved profiles or starter templates.
- **Layouts and sessions:** Saves and restores window layouts, terminals and Chrome windows.
- **Local only:** Runs over stdio with no network calls.

## Good for

- Give each coding agent its own named Space
- Jump to the Research desktop by name
- Open a link on a specific Space
- Restore your window layout after a restart

## Install

### Claude Code (Terminal)

```sh
claude mcp add spacepal -- npx -y spacepal-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "spacepal": {
      "command": "npx",
      "args": [
        "-y",
        "spacepal-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "spacepal": {
      "command": "npx",
      "args": [
        "-y",
        "spacepal-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "spacepal": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "spacepal-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "spacepal": {
      "command": "npx",
      "args": [
        "-y",
        "spacepal-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "spacepal": {
      "command": "npx",
      "args": [
        "-y",
        "spacepal-mcp"
      ]
    }
  }
}
```

## Tools

- `list_spaces`: Every Space with number, name, display, apps, note and active state.
- `current_space`: The Space you are on.
- `switch_space`: Switch by number or name, or step next, previous or back.
- `move_window_to_space`: Send the frontmost window to a Space.
- `open_url`: Open a link in a new browser window on a chosen Space.
- `rename_space`: Name a Space.
- `set_space_note`: Attach a short note to a Space.
- `open_overview`: Open Spacepal's overview grid.
- `list_profiles`: Names of saved profiles.
- `apply_profile`: Apply a saved profile.
- `apply_template`: Name Spaces from a starter template.
- `set_up_space`: Switch to a Space and run its automations.
- `save_window_layout`: Save which Space and position each window is in.
- `restore_window_layout`: Put windows back from the last saved layout.
- `save_sessions`: Save terminal sessions and Chrome windows.
- `restore_sessions`: Reopen saved sessions on their Spaces.
- `place_window`: Put the front window in a half, quarter, maximized or centred.
- `set_presentation_mode`: Hide Space names, notes and previews for screen sharing.
- `add_desktop`: Add a desktop on the current display.
- `remove_desktop`: Remove a desktop and move its windows elsewhere.

## FAQ

### Does it need the app?

Yes, Spacepal must be running.

### Which macOS version?

macOS 14 or later.

### Is the server open source?

Yes, MIT.

### Does it send data out?

No network calls; Space names stay local until passed to your AI client.

### Is Spacepal free?

Spacepal is a paid product with a free trial.

### How do I add Spacepal to Claude Code?

Run this command in your terminal: claude mcp add spacepal -- npx -y spacepal-mcp

### What are the best alternatives to Spacepal?

The closest alternatives to Spacepal are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/spacepal
