← home // about // projects // contact
← Back to projects

CLICKUP BOT

AI-powered task management automation

Python Flask Groq AI GitHub API ClickUp API

// overview

An intelligent bot that automates task management in ClickUp using Groq AI to analyze GitHub activity. Automatically creates, updates, and organizes tasks based on commits and pull requests.

Key features:

  • Automatic ClickUp task creation from GitHub commits
  • AI analysis of commit messages using Groq LLM for categorization
  • GitHub Webhook integration for real-time activity tracking
  • Automatic task status updates based on PR merges
  • Flask REST API for webhook endpoint and configuration
  • Mapping GitHub branches to ClickUp lists

How it works

# Workflow

1. Developer pushes a commit to GitHub

2. GitHub sends a webhook to the Flask server

3. Groq AI analyzes the commit message

4. Bot creates/updates a task in ClickUp

5. Task receives labels, priority, and description

Architecture

The Python Flask server receives GitHub webhook events. Each commit is analyzed through Groq AI, which extracts the type of change (feature, bugfix, refactor, etc.) and generates a structured description for a ClickUp task. The bot uses the ClickUp API v2 for CRUD operations on tasks.

// architecture

GitHub
commits & pull requests
webhook
Flask API
Python webhook receiver
analyze
Groq AI
commit analysis & categorization
create/update
ClickUp API
task management

// documentation

Documentation Open PDF

Project documentation available as PDF

View Documentation