Welcome to ClickMongrel

Seamless ClickUp integration for Claude AI - Automatically sync tasks, track time, and manage projects without leaving your development environment.

View on GitHub Get Started

✨ Key Features

🔄 Real-time Sync

Automatically sync Claude's TodoWrite tasks with ClickUp in real-time. No manual updates needed.

🎯 Smart Status Mapping

Intelligent mapping between Claude and ClickUp task statuses with customizable workflows.

⏱️ Time Tracking

Automatic time tracking from task start to completion with detailed time logs.

📊 Goal Management

Track project goals and milestones directly from Claude with progress visualization.

🔗 Commit Linking

Link git commits to tasks for complete development traceability.

📝 Natural Language

Create tasks using natural language - Claude understands your intent.

🚀 Quick Start

Get up and running in just 3 simple steps:

Step 1: Install and Build

# Clone the repository
git clone https://github.com/hellocory/clickmongrel.git
cd clickmongrel

# Install dependencies and build
pnpm install && pnpm run build

Step 2: Configure ClickUp

# Run the interactive setup wizard
pnpm run setup

# Or set your API key manually
export CLICKUP_API_KEY="pk_your_api_key_here"

Step 3: Add to Claude

# Add ClickMongrel to Claude Code
claude mcp add clickmongrel \
  --env CLICKUP_API_KEY=your_key \
  -- node /path/to/clickmongrel/dist/index.js

That’s it! Start using TodoWrite in Claude and watch your tasks sync automatically to ClickUp.

📚 Documentation

📖 Available Guides

Getting Started

• 📋 Quick Setup Guide
• 🔧 Manual Setup
• 🔒 Security Best Practices

API Reference

• 🛠️ MCP Tools
• ⚙️ Configuration
• 🔗 ClickUp Integration

Features

• ⏱️ Time Tracking
• 🎯 Goal Management
• 📝 Task Templates

🛠️ Available MCP Tools

Tool	Description
sync_todos	Sync TodoWrite tasks with ClickUp
create_task	Create a new task in ClickUp
update_task	Update an existing task
track_time	Track time spent on a task
create_goal	Create a project goal
link_commit	Link a git commit to a task
generate_report	Generate progress reports
list_tasks	List tasks from a list or space

💻 Example Usage

In Claude:

// Create tasks with TodoWrite - automatically syncs!
TodoWrite: 
- [ ] Implement user authentication
- [x] Update API documentation
- [ ] Add unit tests for auth module

// Track time on a specific task
track_time({
  task_id: "abc123",
  duration: 45,
  description: "Implemented OAuth2 flow"
})

// Generate a weekly progress report
generate_report({
  type: "weekly",
  include_commits: true,
  include_time: true
})

🎯 Perfect For

• Development Teams - Track sprints, link commits, and generate reports
• Solo Developers - Stay organized with automatic task tracking
• Project Managers - Monitor progress across multiple projects
• Content Creators - Manage content calendars and publishing schedules

🤝 Contributing

We welcome contributions! Please check our Contributing Guide for details.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Ready to supercharge your workflow?

Join developers using ClickMongrel to streamline their development process

GitHub Report Issue Discussions

Made with ❤️ by the ClickMongrel team

GitHub • NPM • ClickUp API • MCP Docs