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/getspaceIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
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.
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 foundOur 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.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| getspace (this skill)by Hugo-SEQUIER | 78 | 3 | 7d ago | MCP Server |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.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.
Skill content
View source on GitHubSpace
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:8080and 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
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
