date-operations-mcp

The Date Operations MCP Server is a specialized Model Context Protocol (MCP) server designed to provide reliable date calculations tailored for UK contexts, specifically aiding James Murrell's BA workflow.

Key Features

• Working Day Calculations: Automatically excludes weekends and UK bank holidays to ensure accuracy.
• UK Bank Holiday Integration: Leverages live data directly from the GOV.UK API for up-to-date holiday information.
• Asana-Specific Helpers: Implements rules for task scheduling in Asana, such as automatically determining the next working day that falls at 4 PM, and rolling Friday tasks over to Monday.
• Sprint Planning Tools: Facilitates the calculation of sprint dates and provides insights into current sprint progress.
• UK Timezone Handling: Manages all date operations within the Europe/London timezone addressing both GMT and BST.

Available Tools

The MCP Server offers several essential tools:

Basic Date Operations

• get_today_uk: Retrieves the current date adjusted for the UK timezone.
• get_next_working_day: Identifies the next working day following a specified date.
• calculate_working_days: Adds or subtracts a defined number of working days from a specified date.
• get_working_days_between: Calculates the number of working days between two dates.

UK Bank Holidays

• is_uk_bank_holiday: Determines whether a specific date is recognized as a UK bank holiday.
• get_upcoming_bank_holidays: Lists upcoming UK bank holidays with an option to define how many months ahead to fetch.

Sprint Planning

• calculate_sprint_dates: Computes the start and end dates for a defined sprint duration.
• get_current_sprint_info: Retrieves details on the current sprint, including the number of remaining days.

Asana Helpers

• get_asana_due_date: Calculates the due date for Asana tasks following James's scheduling rules.
• parse_asana_date_request: Translates natural language date requests into actionable Asana due dates.

Example Usage

Upon configuration, the MCP Server seamlessly integrates with Claude for date-related requests.

You: "What's 5 working days from today?"
Claude: [Utilizes calculate_working_days tool] That's Wednesday, October 29, 2025

You: "Create an Asana reminder for next week"
Claude: [Utilizes parse_asana_date_request tool] Setting due date to Monday, October 27, 2025 at 4:00 PM

You: "When do we finish the current sprint?"
Claude: [Utilizes get_current_sprint_info tool] Current sprint ends Friday, October 31, 2025

Technical Details

• Language: Developed using TypeScript.
• Runtime: Runs on Node.js.
• Date Management: Utilizes the date-fns library for superior date handling including timezone support.
• Bank Holidays: Sources data from the official GOV.UK API, with caching in place for 24 hours to optimize performance.

In summary, the Date Operations MCP Server significantly enhances the handling of date calculations within a UK context. Its robust features streamline scheduling and sprint planning while ensuring compliance with local holidays and time conventions.