Add TODO CRUD Operations and Claude Code CLI Support

[Ajinkya259]

Summary

This PR adds two major improvements to the Basecamp MCP server:

1. Full CRUD operations for Basecamp todos - Expanding from read-only to complete todo management
2. Claude Code CLI support - Making the server compatible with Claude Code CLI alongside existing Claude Desktop and Cursor support

Changes

🎯 New TODO Operations (5 new tools)

Previously, the MCP server only supported reading todos. This PR adds complete CRUD capabilities:

• create_todolist - Create new todo lists in any project
• create_todo - Create todos with assignees, due dates, start dates, and descriptions
• update_todo - Update existing todos (content, description, assignees, dates)
• complete_todo - Mark todos as complete
• uncomplete_todo - Reopen completed todos

Why this matters:

• Users can now fully manage their Basecamp todos through AI assistants
• Enables complete project management workflows
• Significantly expands the utility of the MCP server

Implementation details:

• Added 5 new methods to BasecampClient class
• Registered 5 new MCP tools in the server
• All operations use official Basecamp 3 API endpoints
• Full TypeScript type safety maintained

📚 Claude Code CLI Support

Added comprehensive setup instructions for Claude Code CLI users:

• Proper claude mcp add command syntax with --transport stdio
• Environment variable configuration examples
• Project-scope vs user-scope setup options
• Verification commands (claude mcp list, claude mcp get)
• Usage examples specific to Claude Code CLI

Why this matters:

• Claude Code CLI is an official Anthropic tool for terminal-based AI assistance
• Many developers prefer CLI workflows over desktop applications
• Provides consistency across Claude Desktop, Cursor, and Claude Code

📝 Documentation Updates

• Updated tool count from 46 to 51 tools
• Added usage examples for all new TODO operations
• Enhanced examples for Claude Desktop and Cursor
• Clearer setup instructions across all platforms
• Better documentation structure

Testing

All new TODO operations have been tested:

✅ Created todo lists successfully
✅ Created todos with various parameters (assignees, due dates, descriptions)
✅ Updated existing todos
✅ Completed and uncompleted todos
✅ Verified all operations work through MCP protocol

Compatibility

This PR maintains full backward compatibility:

• All existing tools continue to work
• No breaking changes to API
• Only additions, no modifications to existing functionality

Files Changed

• src/index.ts - Added 5 new MCP tool handlers
• src/lib/basecamp-client.ts - Added 5 new client methods
• src/test/utils.ts - Updated test utilities
• README.md - Added Claude Code CLI section and TODO operation documentation
• package-lock.json - Dependency updates
• tsconfig.json - Configuration updates

Migration Guide

No migration needed! Simply:

1. Pull the latest changes
2. Run npm install and npm run build
3. Restart your AI assistant (Claude Desktop, Cursor, or Claude Code)
4. The 5 new TODO tools will be available immediately

Future Enhancements

Potential follow-up improvements:

• Delete todos (move to trash)
• Reorder todos within lists
• Add comments to todos
• Bulk operations

---

Tested with:

• Claude Desktop ✅
• Cursor IDE ✅
• Claude Code CLI ✅

Basecamp API version: Basecamp 3
License: MIT (unchanged)