project-handoffs
An MCP tool for aiding persistence over ai-coding-agent sessions.
Documentation
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 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.Frequently asked questions
What is project-handoffs?
project-handoffs is An MCP tool for aiding persistence over ai-coding-agent sessions.
How do I install project-handoffs?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is project-handoffs open source?
Yes — it is hosted on GitHub at https://github.com/davidorex/project-handoffs and has 7 stars.
Related MCP tools
🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.
Use any LLMs (Large Language Models) for Deep Research. Support SSE API and MCP server.
Enhanced MCP server for interactive user feedback and command execution in AI-assisted development, featuring dual interface support (Web UI and Desktop Application) with intelligent environment detection and cross-platform compatibility.
A powerful Zotero AI and MCP plugin with ChatGPT, Gemini 3.7, Claude Fable 5, Claude Opus 5, DeepSeek V4, Grok, OpenRouter, Kimi k3, GLM 5.3, SiliconFlow, GPT-oss, Gemma 4, Qwen 3.8
Connect your browser to AI models. Just use Dia on Chrome, Arc or Firefox.
文颜 MCP Server 可以让 AI 自动将 Markdown 文章排版后发布至微信公众号。
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP