Weekness — Week & Calendar Utilities
MCP server with ISO week and calendar tools for date conversion, week math, and weekday lookups.
Open source Open in the app JSON README (API)
About
MCP server with ISO week and calendar tools for date conversion, week math, and weekday lookups.
Details
- Kind
- MCP servers
- Topic
- Productivity
- Publisher
- dvdksn
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.0
- Last push
- 2026-06-03T07:31:14Z
- Repository state
- ativo
- Language
- Go
- Added
- 2026-08-29 03:02:44
- Updated
- 2026-08-29 03:02:44
- Origin id
io.github.dvdksn/weekness
README
# 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)