Generate printable calendar
generate_calendarUse this when the user wants a printable calendar ("printable calendar", "2027 calendar printable", "monthly calendar template", "yearly calendar", "wall calendar", "school year calendar", "calendar with holidays") as a PDF. Builds a year on one page, a 12-month wall calendar with cover, a single month, or a month range up to 24 months, with public holidays for a country and state, custom birthdays and events, Monday or Sunday weeks, ISO week numbers, notes lines, paper size, language and an accent colour. Returns a preview and a PDF download link. Does not add events to Google, Outlook or Apple calendars, does not schedule meetings, and does not draw lunar, Hijri or Hebrew calendars.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"layout": "<layout>"
},
"name": "generate_calendar"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | For layout range: last month as YYYY-MM (at most 24 months after start), e.g. 2027-06. | |
| year | No | Year for layout year or wall, e.g. 2027. Default: next year from October on, otherwise this year. | |
| bleed | No | Add a 0.125 in print bleed with trim marks in the PDF boxes, for professional printing. Default false. | |
| month | No | For layout month: the month as YYYY-MM, e.g. 2027-03. | |
| notes | No | Add a ruled notes area under each month page (not on the one-page year). Default false. | |
| paper | No | Paper size: letter (8.5x11 in), a4, a3 or tabloid (11x17 in). Default letter for US/Canada/Mexico, a4 for other countries. | |
| start | No | For layout range: first month as YYYY-MM, e.g. 2026-08. | |
| title | No | Optional title printed on the calendar, e.g. "Kowalski Family 2027". Default: the year or month. | |
| accent | No | One accent colour for headings and holiday marks: a hex code like #0F766E or a name (indigo, blue, navy, teal, green, olive, red, crimson, pink, purple, orange, amber, brown, slate, gray, black). Default indigo. | |
| events | No | Custom events and birthdays (up to 60). Example: [{"date":"03-04","title":"Mom's birthday"},{"date":"2027-06-12","title":"Wedding"}] | |
| layout | Yes | year = whole year on one page; wall = 12-month wall calendar, a cover plus one month per page; month = one month on one page; range = one page per month from start to end (e.g. a school year). Example: wall | |
| country | No | Country for public holidays: ISO two-letter code or name, e.g. US, GB, DE, PL, FR, JP, BR, AU, CA. Omit for a calendar without holidays. | |
| holidays | No | Show public holidays when a country is given. Default true; false hides them. | |
| language | No | Language for month and weekday names: en (default), pl, de, es, fr, it, pt, nl or ja. Holiday names use this language when the country's data has it, else English. Example: de | |
| week_start | No | First day of each week row. Default: the country's custom (Sunday for US, CA, BR, JP...; Monday for most of Europe); without a country, Sunday for English, Monday otherwise. Example: monday | |
| orientation | No | Page orientation. Default landscape. Example: portrait | |
| start_month | No | First month (1-12) for a 12-month year or wall calendar; 8 makes an August-to-July academic calendar. Default 1. | |
| subdivision | No | Optional state, province or region for local holidays, e.g. TX or CA (US), BY (Bavaria, DE), SCT (Scotland), NSW (AU), ON (CA). | |
| week_numbers | No | Print ISO 8601 week numbers beside each week row. Default false. Example: true | |
| include_observances | No | Also show observances, bank and optional days (e.g. Mother's Day, Valentine's Day, Christmas Eve). Default false: public holidays only. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| names | Yes | ||
| notes | Yes | ||
| pages | Yes | ||
| paper | Yes | ||
| title | Yes | ||
| accent | Yes | ||
| events | Yes | ||
| inputs | Yes | ||
| layout | Yes | ||
| months | Yes | ||
| period | Yes | ||
| region | Yes | ||
| holidays | Yes | ||
| language | Yes | ||
| downloads | Yes | ||
| notes_area | Yes | ||
| page_count | Yes | ||
| week_start | Yes | ||
| event_count | Yes | ||
| orientation | Yes | ||
| week_numbers | Yes | ||
| holiday_count | Yes | ||
| holidays_shown | Yes | ||
| include_observances | Yes |