Skip to content
MCP server

Spacepal

Name, list and switch macOS Spaces from Claude or Cursor, locally

Runs locallyStatus and history
Pricing
Free trial
Platforms
macOS, CLI
Runs
Locally
Version
0.8.0
Listing updated
3 days ago

About Spacepal

Spacepal is an MCP server for productivity. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add spacepal -- npx -y spacepal-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "spacepal": {
      "command": "npx",
      "args": [
        "-y",
        "spacepal-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "spacepal": {
      "command": "npx",
      "args": [
        "-y",
        "spacepal-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (20)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Free trial

MCP server free (MIT); Spacepal app $9.99 once with 14-day trial (regular $12.99)

Prices change. Check getspacepal.com before you buy.

Spacepal 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 to Spacepal

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media