Project Handoffs MCP Server

MCP server for managing AI session handoffs and next steps tracking.

Core Concepts

NextStep → WorkingSession → Handoff → New NextStep chains
Project-based organization
Priority levels mapped to implementation impact:
- core-critical: Critical for working implementation
- full-required: Necessary for desired implementation
- enhancement: Improvements and optimizations

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

Installation


npm install
npm run build

Configuration

Add to your MCP configuration:


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

Project Structure


project-handoffs/
├── src/
│   ├── index.ts           # Server implementation
│   ├── templates.ts       # Entity templates
│   ├── types.ts          # TypeScript types
│   └── errors.ts         # Error handling
├── package.json          
└── README.md

Development


# Install dependencies
npm install
 
# Development mode
npm run dev
 
# Build
npm run build
 
 
## Implementation Details
 
- Error handling through ProjectError class
- Template validation for all entity types
- Consistent state management
- Safe data persistence with proper error handling
- Type-safe implementation following project-memory-server patterns
 
## Security
 
If you discover a security vulnerability, please create a new issue with the label 'security'. We take all security reports seriously and will respond promptly.
 
## Contributing
 
Contributions are welcome. Feel free to submit a Pull Request.
 
## License
 
This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.