Dorabot – Vietnam public holidays & business days
RemoteAbout Dorabot – Vietnam public holidays & business days
A Vietnam holiday and business-day library for attendance, payroll and deadline applications, with data for 2026–2040. It accounts for compensatory days, official workday swaps, lunar Tết and different schedules for public-sector and private employers, and can count or add business days.
Key features
- 01Vietnam holiday data for 2026–2040
- 02Compensatory days and official workday swaps
- 03Lunar-calendar Tết dates
- 04Schedules for public and private employers
- 05Count and add business days
Use cases
- 01Calculate attendance and payroll periods
- 02Estimate delivery or processing deadlines
- 03Check whether a date is a holiday or make-up workday
MCP support
An MCP server for Claude, ChatGPT, Cursor and other clients provides access to Vietnam holiday and business-day information.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://dorabot.io/lich-am/mcpclaude mcp add --transport http io-dorabot-ngay-le https://dorabot.io/lich-am/mcp{"mcpServers":{"io-dorabot-ngay-le":{"type":"http","url":"https://dorabot.io/lich-am/mcp"}}}Open in Cursor{"servers":{"io-dorabot-ngay-le":{"type":"http","url":"https://dorabot.io/lich-am/mcp"}}}Open in VS Code{"mcpServers":{"io-dorabot-ngay-le":{"type":"http","url":"https://dorabot.io/lich-am/mcp"}}}{"mcpServers":{"io-dorabot-ngay-le":{"serverUrl":"https://dorabot.io/lich-am/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project README@dorabot-io/ngay-le
Ngày nghỉ lễ, Tết Việt Nam cho app chấm công, tính lương, hạn giao hàng, hạn xử lý hồ sơ — có đủ thứ mà thư viện ngày lễ quốc tế thiếu:
- Nghỉ bù khi ngày lễ trùng thứ Bảy/Chủ nhật (Điều 111 Bộ luật Lao động 2019).
- Hoán đổi ngày làm việc theo thông báo hằng năm của Bộ Nội vụ (vd 2026: nghỉ 02/01, đi làm bù thứ Bảy 10/01).
- Tết Âm lịch đúng ngày theo âm lịch, đúng phương án Bộ Nội vụ chọn.
- Ngày Văn hóa Việt Nam 24/11 — ngày nghỉ hưởng lương mới từ 2026 (Nghị quyết 28/2026/QH16).
- Hai nhóm: cán bộ, công chức (
nha_nuoc) và doanh nghiệp (nghỉ tuần T7+CN hoặc chỉ CN, không hoán đổi).
Dữ liệu 2026–2040. Năm đã có thông báo của Bộ Nội vụ: theo thông báo (có số văn bản + link). Năm chưa có: tính theo luật, đánh dấu duKien: true.
npm i @dorabot-io/ngay-le
import { lichNghiLe, kiemNgay, demNgayLamViec, congNgayLamViec } from '@dorabot-io/ngay-le';
lichNghiLe(2026);
// [{ ten: 'Tết Dương lịch', tu: '2026-01-01', den: '2026-01-04', hoanDoi: [{ nghi: '2026-01-02', lamBu: '2026-01-10' }], nguon: {...} },
// { ten: 'Tết Âm lịch (Tết Nguyên đán)', tu: '2026-02-14', den: '2026-02-22', soNgay: 9, ... }, ...]
kiemNgay('2026-01-10'); // { nghi: false, lyDo: 'lam_bu', ten: 'Làm bù cho ngày 2026-01-02 …' } ← thứ Bảy vẫn đi làm
kiemNgay('2026-04-27'); // { nghi: true, lyDo: 'nghi_bu', ten: 'Nghỉ bù Giỗ Tổ Hùng Vương …' }
kiemNgay('2026-11-24'); // { nghi: true, lyDo: 'le', ten: 'Ngày Văn hóa Việt Nam (24/11)' }
demNgayLamViec('2026-02-01', '2026-02-28'); // 15 — công chuẩn tháng 2/2026
congNgayLamViec('2026-02-13', 3); // '2026-02-25' — hạn 3 ngày làm việc, qua Tết
kiemNgay('2026-01-02', { doiTuong: 'doanh_nghiep_cn' }); // { nghi: false } — doanh nghiệp không hoán đổi
doiTuong: nha_nuoc (mặc định), doanh_nghiep_t7cn, doanh_nghiep_cn. Doanh nghiệp tự chọn 5 ngày Tết Âm lịch; gói dùng phương án của khu vực nhà nước — app cho chỉnh nếu công ty chọn khác.
Còn có: Python pip install dorabot-ngay-le, REST GET https://dorabot.io/lich-am/api/ngay-le.php?nam=2026, MCP https://dorabot.io/lich-am/mcp (cho Claude, ChatGPT, Cursor). Lịch âm, ngày tốt, văn khấn: https://dorabot.io/lich-am/
Giấy phép: code MIT, dữ liệu CC BY 4.0 (ghi nguồn "Dorabot (dorabot.io)"). Thông báo mới của Bộ Nội vụ được cập nhật trong vài ngày (nâng version); thấy sai: [email protected]. Dorabot (dorabot.io) là công cụ của Việt Nam, không liên quan tới dorabot.com.
English. Vietnam public holidays 2026–2040 with compensatory days off, government-announced working-day swaps (e.g. work on Saturday 10 Jan 2026), lunar-calendar Tết, and the new 24 November Vietnamese Culture Day (from 2026). kiemNgay(date) = is it a day off, demNgayLamViec(from, to) = business days, congNgayLamViec(date, n) = add n business days. Public sector vs private companies (Sat+Sun or Sun-only weekly rest). Code MIT, data CC BY 4.0.
Trong repo này
js/— gói npm@dorabot-io/ngay-lepython/— PyPIdorabot-ngay-ledata/ngay-le.json— dữ liệu dùng chung (cũng có qua API)- Thấy Bộ Nội vụ ra thông báo mới chưa cập nhật: mở issue kèm link văn bản.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.