# On Board

> On Board is an open-source MCP server for knowledge and memory. Shared project memory and tickets so one coding agent can continue where another stopped. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI, self-hosted
- **Website:** https://swisspra.github.io/On_Board/
- **Repository:** https://github.com/swisspra/on_board
- **MCP Registry name:** io.github.swisspra/On_Board
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-15

## About

On Board keeps a .agent-mem folder inside your project that every agent reads and writes, so a different MCP client can continue the work without you re-explaining it. The loop it describes is onboard, read memory, claim work, write progress, hand off. Claude Desktop, Claude Code, Codex, Cursor and Antigravity are named as clients.

Since v4 an agent can park inside memory_wait_for_event and wake as soon as a peer creates a ticket, submits work or delivers a verdict. The site describes a launch trial where a Codex agent and a Claude agent completed a reject, fix and resubmit cycle with no human relay, and the reviewer reproduced a sha256 hash before approving.

Setup is skill-first: `npx skills add swisspra/On_Board --skill onboard` followed by an /onboard prompt, which reuses one shared runtime and configures one project for one client. It needs Node 22.20 for the skills CLI, Python 3.11 for the setup helper and Python 3.10 with uv or pipx for the runtime. Everything stays local unless you connect other tools. The registry entry requires AGENT_PROJECT_DIR.

## Features

- **Project memory folder:** Agents share notes in .agent-mem inside the project.
- **Ticket queue:** Agents claim, progress and hand off tasks.
- **Wake on events:** memory_wait_for_event returns when a peer posts work or a verdict.
- **Handoff history:** The next agent sees what the last one did.
- **Skill-first setup:** An /onboard skill writes the project's MCP config.
- **Local only:** Data stays in the project unless you connect more.

## Good for

- Hand work from Claude to Codex without re-explaining
- Run a reviewer agent that approves or rejects another agent's work
- Keep a project's decisions across sessions
- Coordinate several IDE agents on one repository

## Install

### Claude Code (Terminal)

```sh
claude mcp add on_board --env AGENT_PROJECT_DIR='<AGENT_PROJECT_DIR>' -- uvx onboard-memory-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "on_board": {
      "command": "uvx",
      "args": [
        "onboard-memory-mcp"
      ],
      "env": {
        "AGENT_PROJECT_DIR": "<AGENT_PROJECT_DIR>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "on_board": {
      "command": "uvx",
      "args": [
        "onboard-memory-mcp"
      ],
      "env": {
        "AGENT_PROJECT_DIR": "<AGENT_PROJECT_DIR>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "on_board": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "onboard-memory-mcp"
      ],
      "env": {
        "AGENT_PROJECT_DIR": "<AGENT_PROJECT_DIR>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "on_board": {
      "command": "uvx",
      "args": [
        "onboard-memory-mcp"
      ],
      "env": {
        "AGENT_PROJECT_DIR": "<AGENT_PROJECT_DIR>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "on_board": {
      "command": "uvx",
      "args": [
        "onboard-memory-mcp"
      ],
      "env": {
        "AGENT_PROJECT_DIR": "<AGENT_PROJECT_DIR>"
      }
    }
  }
}
```

## Tools

- `memory_wait_for_event`: Parks until a peer creates a ticket, submits work or delivers a verdict.

## FAQ

### Where is memory stored?

In a local .agent-mem directory in your project, pointed at by AGENT_PROJECT_DIR.

### Which clients work?

Claude Desktop, Claude Code, Codex, Cursor, Antigravity and other MCP clients.

### What do I need installed?

Node.js 22.20+, Python 3.11+ for the setup helper, and Python 3.10+ with uv or pipx for the runtime.

### What does v4 add?

Agents can wake each other through memory_wait_for_event instead of waiting to be told.

### Is On Board free?

Yes. On Board is open source, so you can use and self-host it for free.

### How do I add On Board to Claude Code?

Run this command in your terminal: claude mcp add on_board --env AGENT_PROJECT_DIR='<AGENT_PROJECT_DIR>' -- uvx onboard-memory-mcp

### What are the best alternatives to On Board?

The closest alternatives to On Board are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/on-board
