SkillAgentSearch skills...

getspace

Self-hostable shared workspace and long-term memory for AI agents over MCP: Claude Code, Codex, Cursor and more

Install / Use

claude mcp add Hugo-SEQUIER -- npx -y github:Hugo-SEQUIER/getspace

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

78/100

Supported Platforms

Claude Code
Claude Desktop
Cursor
OpenAI Codex

Tags

Our assessment of getspace

getspace scores 78/100 on our quality scale, 3691st of 4,698 Development & Engineering skills we index.

Its MCP Server is 6.9 KB long, well organised into 9 sections with 4 code examples: a thorough specification that gives an agent plenty to work with.

It has 3 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
29/30
Structure
20/20
Description
12/15
Adoption
3/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 7 days ago, so getspace is actively maintained.
  • Our last check on 2026-11-12 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (1 minor note below). An AI review of the same text found nothing harmful.

  • noteInstalls by piping a downloaded script into a shellline 35
    curl -fsSL https://raw.githubusercontent.com/Hugo-SEQUIER/getspace/main/scripts/install.sh | sudo bash

AI review by kimi-k2.7-code on 2026-11-10. Automated pattern scan on 2026-11-09. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

getspace compared with similar skills

All 4 of these similar skills score higher than getspace; compare them before choosing.

SkillScoreStarsUpdatedFormat
getspace (this skill)by Hugo-SEQUIER7837d agoMCP Server
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md

Frequently asked questions

How do I install getspace?
Run claude mcp add Hugo-SEQUIER -- npx -y github:Hugo-SEQUIER/getspace. The install tabs above show the steps for each supported agent.
Which AI agents does getspace work with?
It is written for Claude Code, Claude Desktop, Cursor and OpenAI Codex, as a MCP Server file. Other agents that read the same format can often use it too.
Is getspace safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (1 minor note below). An AI review of the same text found nothing harmful. It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is getspace still maintained?
The repository was last updated 7 days ago, so getspace is actively maintained.

Space

Space is a workspace your AI agents share with you: documents, tasks, databases and long-term memory that agents read and write over MCP, with a website where you see, correct and edit the same work. Connect Claude Code, Codex, Cursor or any MCP client, and what one session learns is there for the next one.

This repository is the open-source, self-hosted edition. It runs on one machine you control, such as a small VPS, with Docker Compose. It needs no cloud account: no hosted database, object storage, key service or sign-in provider.

What you get

  • Documents and tasks with full revision history, edited from the website or by agents.
  • Databases: typed tables and boards, which agents can query and change with SQL.
  • Agent memory: handoffs between sessions, and claims agents remember, recall with citations, correct and forget.
  • Search and recall across everything in the Space, by words; by meaning too once a model provider is configured.
  • One MCP endpoint for every agent, with a revocable token or browser sign-in per agent and attribution of who wrote what.
  • A REST API with personal API keys, and signed webhooks when database rows change.
  • Projects, folders, sections and categories that agents follow when they file new work.

How it is built

| Part | What it runs | |---|---| | caddy | The only published service. Serves HTTPS with automatic certificates and routes requests. | | web | The website (TanStack Start on Node.js). | | api | The REST API and the MCP endpoint (Python, FastAPI). | | worker | Background memory extraction. | | webhooks | Signed webhook delivery. | | db | PostgreSQL 17 with pgvector. Every document, task, memory and setting lives here. |

Content is stored as readable JSON in PostgreSQL. There is no application-level encryption: whoever operates the server can read the data, as with any self-hosted application. Back up the database and protect the server accordingly.

Install

You need a Linux server with at least 1 GB of memory, such as a small VPS, and, for public access, a domain name whose DNS record points at it. On the server, run:

curl -fsSL https://raw.githubusercontent.com/Hugo-SEQUIER/getspace/main/scripts/install.sh | sudo bash

The installer installs Docker if it is missing, downloads the latest release into /opt/space, asks for the access mode, your domain and your name, starts Space and prints its address and access key. To do the same steps by hand:

git clone https://github.com/Hugo-SEQUIER/getspace.git
cd getspace
git checkout "$(git tag -l 'v*' | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | sort -V | tail -n 1)"   # latest release
scripts/setup.sh                 # asks for the access mode and your domain, writes .env
docker compose up -d             # downloads the released images and starts everything
docker compose exec api python -m space.check   # checks every setting, in plain words

Both offer two access modes:

  • Key mode (default): Space is reachable from the internet at https://your-domain. The website asks for the instance's access key once per browser, and each agent connects with its own revocable token. Point a DNS record at the server and open ports 80 and 443; Caddy obtains the certificate.
  • Private mode: no access check at all. Space listens on 127.0.0.1:8080 and you reach it through an SSH tunnel or a VPN such as Tailscale. Never expose this mode publicly.

There are no user accounts: one installation belongs to one person, the owner. Self-hosting covers both modes, every setting, upgrades, backups and troubleshooting.

Moving from the hosted Space? Export your Space there and import it here: Moving from the hosted Space.

Connect an agent

Open Agents → Connect an agent on the website, choose a name and whether the agent may write, and copy the setup it shows. For Claude Code:

claude mcp add --transport http space https://your-domain/mcp/ \
  --header "Authorization: Bearer spc_..."

Hosted assistants such as claude.ai and ChatGPT sign in instead: add https://your-domain/mcp/ to the app as a custom connector, and approve it when it opens Space in your browser.

In private mode agents need no token: claude mcp add --transport http space http://127.0.0.1:8080/mcp/. Connecting agents has setups for Codex, Cursor and other clients, and the optional agent skills teach an agent when to recall, remember and hand off.

Memory with a model provider

Documents, tasks, databases, handoffs and word search work without any model. Automatic memory (extracting claims from text, embeddings and semantic recall) needs an OpenAI-compatible endpoint or Ollama; set SPACE_MEMORY_PROVIDER and the related settings in .env. Only the text an agent asks Space to process is sent to that provider. A decision model on OpenRouter's Decisions API can also assess recall evidence, organize memories against your categories and projects, and link related memories; each of those is off until you turn it on. See memory.

Back up and upgrade

scripts/backup.sh                                  # writes backups/space-<time>.dump
scripts/upgrade.sh                                 # backs up, then moves to the latest release
scripts/restore.sh backups/space-<time>.dump       # replace this installation's data

Copy backups off the server: a backup on the same disk is not a backup.

Documentation

| Document | What it covers | |---|---| | Self-hosting | Install, access modes, configuration, upgrades, backups, security and troubleshooting. | | Moving from the hosted Space | Exporting a hosted Space and importing it into your own installation. | | Connecting agents | Tokens, client setups, agent identities and the device-code flow. | | Architecture | Processes, storage, access control and background work. | | Development | Running from source, tests and checks. | | MCP | The agent interface and its tools. | | Memory | Handoffs, claims, recall and the claim index. | | Webhooks | Signed notifications when database rows change. | | Glossary | Every term the system uses. | | API reference | The REST API a personal API key can call (OpenAPI). |

License

Space is free software under the MIT License. You may use, change, share and self-host it for any purpose, including commercially, as long as the copyright and permission notice stays with copies or substantial portions of the software. The vendored Memora runtime keeps its own MIT license; see NOTICE and THIRD-PARTY.md.

Contributions are welcome. Read CONTRIBUTING.md and accept the Contributor License Agreement before your first pull request.

Related Skills

View on GitHub
GitHub Stars3
CategoryDevelopment
Updated7d ago
Forks0

Languages

Python

Trust signals

92/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 low