Loonflow is an open-source Django-based process automation platform with MCP ticket server support, offering multi-tenant and extensible design through plugins and a REST API.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Loonflow is an open-source process automation platform developed based on Django. It supports multi-type tickets, automation and smart routing, comprehensive audit logs, and authentication methods including Microsoft OIDC and Wecom QR scan login. It provides a Model Context Protocol (MCP) ticket server to interact with MCP-compatible clients.
How it works
The MCP component exposes a ticket server with endpoints for listing and handling tickets via authenticated tools. Registered MCP tools include ticket_list, ticket_detail, ticket_prepare_handle, ticket_handle (supports dry_run), and user_list (paginated within the authenticated tenant). The system is designed to be extendable via a plugin architecture and a comprehensive REST API for integration with external systems.
Getting started
Installation & Deployment steps provided:
- Download docker-compose related files
wget https://raw.githubusercontent.com/blackholll/loonflow/refs/heads/master/docker_compose_deploy/docker-compose.yml
wget https://raw.githubusercontent.com/blackholll/loonflow/refs/heads/master/docker_compose_deploy/.env
- Modify the .env file Please modify at least the password section
- Start docker-compose Navigate to the directory containing docker-compose.yml and execute:
docker-compose up -d
- Access loonflow Login to loonflow using the email and password you set in the .env file.
Recent releases
- r3.2.2 (2026-05-25): - Bugfix: In Safari, the operation time in the ticket operation history is displayed as "invalid date"; - Bugfix: Ticket creator as participant not able to handle ticket
- r3.2.1 (2026-05-13): - Feature: Add MCP tool to retrieve user list; - Bugfix: Role list page now shows only current tenant's roles (previously showed all tenants); - Bugfix: Workflow design page: fix issue where role could
- r3.2.0 (2026-05-04): - Feature: add MCP ticket server; - Feature: add about Information on Frontend page; - Optimize: user info display optimization (ticket list and ticket history record); - Optimize: added user guidance for;
- r3.1.0 (2026-03-24): - Feature: add Microsoft OIDC and wecom QR scan login; - Feature: add file & rich text & external data field; - Feature: add workflow design auto layout feature; - Security: security issues fix
- r3.0.1 (2025-12-12): - Docker Compose: custom Redis/Postgres ports, drop version key, ARM build, pinned tags; - User-facing: reset personal password; choose workflow version on create; English publish hint; flow preview n
Traction
Stars: 2088, Forks: 706, Open issues: 20
Behind the repo
License: AGPL-3.0; Created: 2018-02-08; Last push: 2026-05-25 Language: TypeScript Topics: devops, django, mcp, python, ticket, workflow, workflow-engine
Caveats
License: AGPL-3.0; Open issues: 20; Last push: 2026-05-25