# Weekness MCP Server

<!-- mcp-name: io.github.dvdksn/weekness -->

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

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

### Build from source

```bash
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`

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

Or if running from a local build:

```json
{
  "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)