workflow automation⏱10 minutes
Get Started with Agenda
Quick Summary
“Lightweight job scheduler for Node.js applications.”
Best for: Node.js applications needing recurring job scheduling
Time to first integration: 10 minutes
📋Prerequisites
- ✓Node.js 18+ installed
- ✓A Agenda account — sign up here
- ✓An existing project (Next.js, React, or Node.js recommended)
Setup Steps
4 steps1
1
Install Agenda
Add Agenda to your Node.js project using npm.
bash
npm install agenda2
2
Connect to MongoDB
Configure Agenda to connect to your MongoDB instance.
javascript
const agenda = new Agenda({ db: { address: 'mongodb://localhost/agenda' } });3
3
Define a job
Create a job definition using Agenda's API.
javascript
agenda.define('send email', async job => { /* email logic */ });4
4
Schedule a job
Use Agenda to schedule the job to run at a specific interval.
javascript
agenda.every('3 minutes', 'send email');Common Gotchas
Watch out for these issues in your first week.
Jobs not executing as expected
Fix: Ensure MongoDB connection is stable and check for concurrency issues.
Job duplication
Fix: Implement idempotency checks within job logic.
Related Guides
Setting up a full stack? Check out these complementary guides.