Weekness MCP Server

An MCP (Model Context Protocol) server that provides week and calendar helper tools for converting between dates and ISO weeks, performing week arithmetic, and looking up weekday names.

Tools

• current_date: Get today's date (YYYY-MM-DD) and weekday name
• current_week: Get today's ISO week year, week number, week string, and weekday name
• timestamp_to_week: Convert a date or timestamp to its ISO week number and week string
• week_to_dates: Get the Monday start date and Sunday end date for an ISO year and week number
• add_weeks: Add or subtract weeks from a date or week string
• weeks_between: Calculate the number of weeks between two dates
• weekday_of_date: Get the weekday name for a given date
• nearest_weekday: Find the nearest past or future occurrence of a given weekday

Installation

Docker

docker run --rm -i ghcr.io/dvdksn/weekness:latest

Build from source

go build -o weekness .

Usage

This MCP server communicates over stdio and is designed to be used with MCP clients like Claude Desktop or other applications that support the Model Context Protocol.

Configure in Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "weekness": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/dvdksn/weekness:latest"]
    }
  }
}

Or if running from a local build:

{
  "mcpServers": {
    "weekness": {
      "command": "/path/to/weekness"
    }
  }
}

Supported Timestamp Formats

• ISO 8601 with time: 2024-03-15T10:30:00Z
• ISO 8601 with timezone: 2024-03-15T10:30:00-07:00
• Date only: 2024-03-15
• ISO week string: 2024-W15 (where accepted)