The Project Handoffs MCP Server is a tool for managing AI session handoffs and tracking next steps within projects.
With this server, you can:
Create and delete projects for organizing your work
Create next steps with title, description, priority, dependencies, and parent steps
Start working sessions for specific next steps
Complete sessions by creating handoffs with details about completed work, code state, unresolved issues, and new next steps
Retrieve open next steps ordered by priority
View complete history for specific next steps
Access templates for next steps, working sessions, and handoffs
Prioritize tasks using levels like 'core-critical', 'full-required', and 'enhancement'
Referenced in the configuration example for running the MCP server, used to locate the Node.js executable on macOS systems.
Manages dependencies and provides build scripts for the project handoffs MCP server, supporting installation and development workflows.
Uses TypeScript for type-safe implementation of the project handoffs tracking system, including proper error handling and consistent state management.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Project Handoffs MCP Servercreate a new project for the customer portal redesign"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Related MCP server: ClickUp MCP Server
Available Tools
list_templates- List available templates for next steps, working sessions, and handoffscreate_project- Create a new project for tracking AI session handoffsdelete_project- Delete a project and all its datacreate_next_step- Create a new next step in a projectstart_working_session- Start working on a next stepcreate_handoff- Complete a working session with handoff detailsget_latest_next_steps- Get open next steps ordered by priorityget_next_step_history- Get complete history of a next step including session and handoff
Installation
npm install
npm run buildConfiguration
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.mdDevelopment
# 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.Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.