MCP Time Server

BrainyCalc Docs — MCP Date & Time Tools

High-precision temporal calculation engine supporting ISO 8601 parsing, timezone conversions, business days, duration math, relative time formatting, and full calendar generation.

All50 date & time calculation toolsare available as a standaloneModel Context Protocol (MCP) server. Install vianpx -y @brainycalc/mcptimeserverto empower AI assistants (LM Studio, Claude Desktop) with deterministic temporal operations.

Get current date and time, optionally formatted or adjusted for a target timezone.

{ "format": "YYYY-MM-DD HH:mm:ss", "timezone": "America/New_York" } "2026-08-11 14:02:00"

- What is the current date and time?
- What is the time right now in New York formatted as YYYY-MM-DD HH:mm:ss?
- Give me today's date and current time.

Format an incoming date into a custom localized token string.

{ "date": "2026-08-11T14:02:00Z", "format": "dddd, MMMM D, YYYY" } "Tuesday, August 11, 2026"

- Show only the month from 2026-08-11.
- Can you reformat '2026/08/11' into 'DD/MM/YYYY'?
- Display this timestamp in full written words: 2026-08-11.

Deconstruct a date string into structured components (year, month, ISO week, quarter, Unix, etc.).

{ "date": "2026-08-11" } { "year": 2026, "month": 8, "day": 11, "dayOfWeek": 2, "dayOfWeekName": "Tuesday", "weekOfYear": 33, "quarter": 3, "unix": 1786406400, "iso": "2026-08-11T00:00:00.000Z" }

- Break down '2026-08-11' into its calendar components.
- What day of the week and week number was August 11, 2026?
- Extract the quarter, year, and ISO week from '2026-08-11'.

Add or subtract specified time units from a base date.

{ "date": "2026-08-11", "amount": 3, "unit": "months" } "2026-11-11T00:00:00.000Z"

- What date will it be 3 months from August 11, 2026?
- Subtract 45 minutes from 10:00 AM today.
- Add 3 weeks to 2026-08-11.

Get start or end boundary of a unit (year, quarter, month, week, isoWeek, day, hour) for a date.

{ "date": "2026-08-11", "unit": "month", "edge": "end" } "2026-08-31T23:59:59.999Z"

- What is the end of August 2026?
- When does the current week end?.
- When does Q3 2026 end?

Resolve English date component terms ('month name', 'unix milliseconds') into format tokens or compose format strings.

{ "part": ["full year", "month", "day"], "compose": true, "separator": "-" } "YYYY-MM-DD"

- What format tokens should I use for 'year-month-day'?
- Compose a format string with full year, month name, and day.
- What is the formatting token for full month name?

Format date according to standardized specifications: ISO 8601, ISO 9075, RFC 3339, or RFC 7231 (HTTP).

{ "date": "2026-08-11T14:30:00Z", "standard": "rfc7231" } "Tue, 11 Aug 2026 14:30:00 GMT"

- Format August 11, 2026 into HTTP RFC 7231 header date format.
- Convert this date into standard ISO 8601 string format.
- Generate an RFC 3339 timestamp for right now.

Strictly parse inputs from ISO strings, JSON date strings, Unix seconds, or Unix milliseconds.

{ "input": 1786406400, "inputType": "unix_s" } { "input": 1786406400, "inputType": "unix_s", "iso": "2026-08-11T00:00:00.000Z", "unix": 1786406400, "unixMs": 1786406400000 }

- Parse this Unix timestamp 1786406400 in seconds into an ISO date.
- Strictly parse "2026-08-11" and convert it to an ISO timestamp.
- Convert Unix epoch milliseconds 1786406400000 into a human readable date.

Convert a date object into alternate representations: array, object, JSON, UTC string, or ISO string.

{ "date": "2026-08-11", "output": "array" } [2026, 7, 11, 0, 0, 0, 0]

- Convert '2026-08-11' into an array of date numbers.
- Export this date as a raw JavaScript date object representation.
- Give me '2026-08-11' as a UTC string.

Parse or convert a date in UTC mode, preserving or converting local wall clock values.

{ "date": "2026-08-11T12:00:00", "keepLocalTime": true } "2026-08-11T12:00:00.000Z"

- Convert local time 12:00 to UTC while keeping the local time numbers.
- Get the UTC date representation for August 11, 2026.
- Parse '2026-08-11T12:00:00' directly in UTC.

Calculate exact differences between two dates (returns scalar value or detailed breakdown).

{ "date1": "2026-08-11", "date2": "2026-12-25" } { "date1": "2026-08-11", "date2": "2026-12-25", "days": 136, "weeks": 19.43, "months": 4.47, "years": 0.3723, "formatted": "19 weeks and 3 days" }

- How many days are between August 11, 2026 and December 25, 2026?
- Calculate the difference in weeks and days between these two dates.

Calculate exact age in years, months, days, total weeks, and total days relative to target date.

{ "birthDate": "1995-05-15", "targetDate": "2026-08-11" } { "birthDate": "1995-05-15", "years": 31, "months": 2, "days": 27, "totalDays": 11411, "totalWeeks": 1630, "formatted": "31 years, 2 months, 27 days" }

- How old is someone born on May 15, 1995 as of August 11, 2026?
- Calculate exact age in years, months, and days for May 15, 1995.
- How many total weeks old is a person born on 1995-05-15?

Evaluate boolean date comparison predicates: isBefore, isAfter, isSame, isSameOrBefore, isSameOrAfter.

{ "date1": "2026-08-11", "date2": "2026-08-15", "comparison": "isBefore" } true

- Is August 11, 2026 before August 15, 2026?
- Check if date A is equal to date B ignoring time.
- Is 2026-08-11 after 2026-08-01?

Check if a date falls between start and end boundaries with configurable inclusivity options.

{ "date": "2026-08-11", "start": "2026-08-01", "end": "2026-08-31", "inclusivity": "[]" } true

- Is today between 2025-01-01 and 2025-12-31?
- Does August 11, 2026 fall within the range August 1 to August 31, 2026?
- Check if '2026-08-11' is strictly between two boundary dates.

Run complete date comparison matrix across all unit granularities simultaneously.

{ "date1": "2026-08-11", "date2": "2026-08-15" } { "compareAsc": -1, "compareDesc": 1, "isSameDay": false, "isSameWeek": true, "isSameMonth": true, "isSameQuarter": true, "isSameYear": true }

- Compare two dates across all units like same week, same month, same year.
- Are August 11, 2026 and August 15, 2026 in the same month and week?
- Get full comparative breakdown between 2026-08-11 and 2026-08-15.

Get a human-readable relative time expression (e.g. '3 days ago', 'in 2 months').

{ "date": "2026-08-01", "relativeTo": "2026-08-11" } "10 days ago"

- How long ago was August 1, 2026 compared to August 11, 2026?
- Format August 1, 2026 as relative time (e.g. '10 days ago').
- Express the date difference human-readably without suffixes.

Locale-aware relative time formatting utilizing standardIntl.RelativeTimeFormat.

{ "date": "2026-08-14", "baseDate": "2026-08-11", "locale": "es" } { "formatted": "dentro de 3 días", "unit": "day", "value": 3, "locale": "es" }

- Show relative time distance in Spanish ('dentro de 3 días') for August 14.
- Get localized relative time distance between August 11 and August 14, 2026.

Find which date in an array of candidates is nearest to a reference date.

{ "date": "2026-08-11", "dates": ["2026-01-01", "2026-08-10", "2026-12-31"] } { "closestIndex": 1, "closestDate": "2026-08-10T00:00:00.000Z", "diffMs": 86400000 }

- Which date in this list [2026-01-01, 2026-08-10, 2026-12-31] is closest to August 11, 2026?

Determine if two date intervals overlap and calculate overlapping days count.

{ "start1": "2026-08-01", "end1": "2026-08-15", "start2": "2026-08-10", "end2": "2026-08-20", "mode": "days" } { "overlaps": true, "overlapDays": 5, "overlapStart": "2026-08-10T00:00:00.000Z", "overlapEnd": "2026-08-15T00:00:00.000Z" }

- Do the date ranges Aug 1-15 and Aug 10-20 overlap?
- Calculate how many days overlap between two event schedules.
- Check if interval 2026-08-01 to 2026-08-15 intersects with 2026-08-10 to 2026-08-20.

Count work days (Mon–Fri) between dates or add/subtract business days from a starting date.

{ "mode": "add", "startDate": "2026-08-07", "amount": 5 } { "original": "2026-08-07", "amount": 5, "result": "2026-08-14" }

- Add 5 business days to Friday, August 7, 2026.
- How many work days are there between August 1 and August 15, 2026?
- Subtract 10 business days from August 11, 2026.

Calculate working days between two dates with optional weekend inclusion flags.

{ "startDate": "2026-08-01", "endDate": "2026-08-11" } { "startDate": "2026-08-01", "endDate": "2026-08-11", "workDaysCount": 7, "weekendsIncluded": false }

- Count the total working days between 2026-08-01 and 2026-08-11.
- How many days excluding weekends are in the first half of August 2026?

Generate a complete month calendar matrix structured into week arrays for calendar UI displays.

{ "date": "2026-08-01", "weekStart": 1 } { "month": "August 2026", "year": 2026, "daysInMonth": 31, "weeks": [ / Arrays containing week objects / ] }

- Generate a full month calendar matrix for August 2026 starting on Monday.
- Get all weeks and dates in August 2026 structured for UI calendar layout.
- Build a monthly calendar view grid for August 2026.

Get array of all weekend dates (Saturday and Sunday) within a specified interval, month, or year.

{ "mode": "month", "date": "2026-08-01" } { "mode": "month", "count": 10, "weekends": ["2026-08-01", "2026-08-02", "2026-08-08", "..."] }

- List all weekend dates (Saturdays and Sundays) in August 2026.
- Get every weekend day date in the year 2026.
- Find all weekend dates between August 1 and August 31, 2026.

Get day name, month name, year, weekend flag, day of year, and week number for any date.

{ "date": "2026-08-11" } { "date": "2026-08-11", "dayName": "Tuesday", "month": "August", "dayNumber": 11, "year": 2026, "isWeekend": false, "dayOfYear": 223, "weekNumber": 2 }

- What day of the week is August 11, 2026?
- Is August 11, 2026 a weekend or weekday?
- What is the day of year number for August 11, 2026?

Return the last day of a period (month, year, quarter, week, isoWeek, decade).

{ "date": "2026-08-11", "unit": "quarter" } { "input": "2026-08-11", "unit": "quarter", "lastDay": "2026-09-30" }

- What is the last day of Q3 2026?
- Find the last day of the month for August 2026.
- What is the last day of the decade for 2026-08-11?

Generate structured remaining time or elapsed time breakdowns relative to a target timestamp.