BullMQ MCP
@adamhancock
A comprehensive BullMQ MCP (Model Context Protocol) server for managing BullMQ Redis-based job queues. This BullMQ MCP integration enables Claude Code and other AI assistants to interact with BullMQ queues, monitor job status, manage workers, and perform queue operations through
Overview
What is BullMQ MCP?
BullMQ MCP is a Model Context Protocol server for managing BullMQ Redis-based job queues. It enables Claude Desktop and other AI assistants to interact with BullMQ queues, monitor job status, manage workers, and perform queue operations through natural language.
How to use BullMQ MCP?
Install via npm, pnpm, yarn, or Docker. Configure Claude Desktop by adding the server to the MCP configuration file with a Redis URL or connection parameters. Use the provided tools such as connect, list_queues, add_job, get_jobs, and others to manage queues and jobs.
Key features of BullMQ MCP
- Manage connections to multiple Redis instances
- Perform queue operations: list, pause, resume, drain, clean
- Add, remove, retry, and promote jobs
- Monitor job details, logs, and statistics
- Clean jobs by status with configurable limits
- Filter jobs by active, waiting, completed, failed, delayed
Use cases of BullMQ MCP
- Connect to Redis and explore existing BullMQ queues
- Add a new job to a queue with custom data and options
- Monitor job progress, view logs, and retry failed jobs
- Perform queue maintenance: drain, clean, pause, resume
- Manage multiple environments (dev, staging, production) via separate connections
FAQ from BullMQ MCP
How do I connect to a Redis instance?
Use the connect tool with a URL, or provide host, port, password, and db parameters. The server also respects the REDIS_URL environment variable if set.
Can I run the server using Docker?
Yes
