# SPM - Structured Project Memory

A hosted MCP server that keeps requirements, decisions and tests in one place and hands them to your agent in the next chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: getspm
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/getspm/spm-agent-connectors
- Updated: 2026-08-14
- HTML: https://affpapa.org/en/nevibecode/mcp/spm-structured-project-memory

## What it does

SPM stores project knowledge as memory that survives across chats, runs and tools. You point a client at the remote endpoint `https://getspm.com/v1/mcp`, and the agent can resolve which project is active, pull the context it needs, then report decisions, tests and evidence back when the work is done.

Memory comes in scoped packs with provenance and expiry. An agent can verify hashes, query temporal state, run policy-aware preflight checks and inspect the capture journal. Pulling context from several projects at once is not automatic — the user has to ask for it, because each task keeps a single active project. Moving to another agent or device goes through a one-time handoff that carries references instead of memory bodies or credentials.

Before anything works you need an SPM account, an organization with at least one project, a trial or paid plan, and a token scoped to one project, a chosen set, or everything the signed-in user may access. Keep that token in an environment variable or the client's secret storage. Committing it to a repo is the wrong move, since tokens are meant to be revocable from SPM. The repository ships native bundles for Codex, Claude, Cursor and OpenClaw, plus authorization helpers and config examples.

## Requirements
- Remote server: `https://getspm.com/v1/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http spm-structured-project-memory https://getspm.com/v1/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add spm-structured-project-memory --url https://getspm.com/v1/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "spm-structured-project-memory": {
            "url": "https://getspm.com/v1/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "spm-structured-project-memory": {
            "type": "http",
            "url": "https://getspm.com/v1/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http spm-structured-project-memory https://getspm.com/v1/mcp
```

## When to use it
- carry project memory into a fresh chat without retyping it
- hand a contractor a bounded slice of a project with sources attached
- check where an agent got its context and whether the hashes match
- record decisions and test results once a task finishes
- resume the same project in another agent or on another machine

## Example prompts
- Show the current requirements and decisions for the active project
- Build a context pack for the `billing` project and verify its provenance
- Report the finished task and passing tests back to SPM

## Similar
- [memory-discipline](https://affpapa.org/en/nevibecode/skills/memory-discipline.md) — skill · 3900 installs
- [claude-memory-curator](https://affpapa.org/en/nevibecode/skills/claude-memory-curator.md) — skill · 2600 installs
- [memory-continue](https://affpapa.org/en/nevibecode/skills/memory-continue.md) — skill · 1300 installs
- [read-working-memory](https://affpapa.org/en/nevibecode/skills/read-working-memory.md) — skill · 765 installs
- [memory-search](https://affpapa.org/en/nevibecode/skills/ruvnet-memory-search.md) — skill · 750 installs
- [memory-reflect](https://affpapa.org/en/nevibecode/skills/basicmachines-co-memory-reflect.md) — skill · 746 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md