home / mcp / project handoffs mcp server

Project Handoffs MCP Server

An MCP tool for aiding persistence over ai-coding-agent sessions.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "davidorex-project-handoffs": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "/path/to/project-handoffs/build/index.js"
      ]
    }
  }
}

This MCP server enables you to manage AI session handoffs and track next steps within a project structure. It provides a streamlined flow from defining a NextStep to conducting a WorkingSession, recording a Handoff, and creating new NextStep chains as work progresses.

How to use

You interact with the Project Handoffs MCP Server by connecting an MCP client and performing common workflows: create a project to organize work, add next steps, start working sessions on those steps, and finish with handoffs that capture the outcomes. You can list available templates to understand how to structure next steps and handoffs, view the latest open next steps by priority, and review complete histories of a NextStep including its sessions and handoffs. Use these capabilities to maintain clear ownership, track progress, and ensure smooth handoffs between teams.

How to install

Prerequisites: ensure Node.js is installed on your system prior to starting the MCP server.

npm install
npm run build
/opt/homebrew/bin/node /path/to/project-handoffs/build/index.js

Configuration

Configure your MCP client to connect to the server using the stdio method shown here. The server is launched by running Node with the built index script.

{
  "mcpServers": {
    "project_handoffs": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/path/to/project-handoffs/build/index.js"],
      "alwaysAllow": []
    }
  }
}

Notes and tips

- This server uses TypeScript and follows a consistent state management approach with explicit entities for NextStep, WorkingSession, and Handoff. - The configuration shown above is intended for local development or controlled environments where the MCP runtime is started as a stdio process. - If you need to adjust runtime options, modify the command and argument values in your MCP configuration as needed.

Available tools

list_templates

List available templates for next steps, working sessions, and handoffs

create_project

Create a new project for tracking AI session handoffs

delete_project

Delete a project and all its data

create_next_step

Create a new next step in a project

start_working_session

Start working on a next step

create_handoff

Complete a working session with handoff details

get_latest_next_steps

Get open next steps ordered by priority

get_next_step_history

Get complete history of a next step including session and handoff