# Listspace

Wires a Listspace board into your agent as project memory, so it reads tasks and logs decisions as work happens. Useful when a project outlives a single session.

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

## What it does

The server hands your agent a Listspace board: it checks what is done, adds items, leaves comments and records decisions. It talks to the REST API at `https://api.listspace.app/v1` and the MCP endpoint at `https://mcp.listspace.app`.

The repo ships a skill under `skills/listspace/` with the work loop in `SKILL.md` and a `reference/` folder, a Claude plugin whose `.mcp.json` registers the remote server, and a Node CLI called `listspace` for agents that skip MCP. Two hooks come with the plugin. One nudges Claude to log a decision with `record_decision` when a turn produced none; the other asks for a board update after file edits, commits or a deploy. Both stay quiet in sessions that never touched a Listspace tool, and neither fires twice in one turn.

The hooks need Node.js 18 or newer. Without it they do nothing at all, and Claude reports no hook error. The CLI keeps its token in `credentials.json` inside the OS config directory, mode 600. If you added the Listspace MCP server by hand earlier, expect two entries after installing the plugin — drop one.

## Requirements
- Remote server: `https://mcp.listspace.app`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http listspace https://mcp.listspace.app
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add listspace --url https://mcp.listspace.app
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "listspace": {
            "url": "https://mcp.listspace.app"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "listspace": {
            "type": "http",
            "url": "https://mcp.listspace.app"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http listspace https://mcp.listspace.app
```

## When to use it
- keep a project board current with what the agent did this session
- log decisions so they survive between sessions
- add a task to the board straight from the chat
- point agents at the right board through `AGENTS.md`
- reach Listspace from an agent without the MCP server, via the CLI

## Example prompts
- Open the project board and show me what is in progress
- Add an idea called Dark mode to the board, description from settings
- Record the switch to the new parser as a Proposed decision

## Similar
- [memory-management](https://affpapa.org/en/nevibecode/skills/memory-management-2.md) — skill · 1100 installs
- [KLYPIX Shared Project Memory](https://affpapa.org/en/nevibecode/mcp/klypix-shared-project-memory.md) — MCP server · ★ 10
- [Gagarin Cloud](https://affpapa.org/en/nevibecode/mcp/gagarin-cloud.md) — MCP server
- [receipts](https://affpapa.org/en/nevibecode/skills/receipts.md) — skill · 2052 installs
- [clickup](https://affpapa.org/en/nevibecode/skills/clickup.md) — skill · 1800 installs
- [paperclip-ai-orchestration](https://affpapa.org/en/nevibecode/skills/paperclip-ai-orchestration.md) — skill · 1500 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