Spacepal
Name, list and switch macOS Spaces from Claude or Cursor, locally
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"spacepal": {
"command": "npx",
"args": [
"-y",
"spacepal-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"spacepal": {
"command": "npx",
"args": [
"-y",
"spacepal-mcp"
]
}
}
}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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media