Shirabe Calendar API — Claude Code MCP server: setup guide
Shirabe Calendar API connects Japanese calendar logic to coding assistants. It helps agents assess dates for weddings, moves, or business openings using Rokuyo and Rekichu cycles.
no license 2,944 installs updated 2026-04-14
claude mcp add --transport http shirabe-calendar https://shirabe-calendar--r-yoshikawa.run.toolsWhat Shirabe Calendar API does
This server supplies AI agents with traditional Japanese calendar calculations. It covers the Rokuyo six-day cycle, Rekichu auspicious markers, Eto zodiac signs, and the 24 Solar Terms. Agents use this context to judge whether a requested date is favorable for events such as starting a business, beginning construction, or holding a wedding.
Three tools handle the queries. The get_japanese_calendar tool inspects a single date and delivers suitability advice for specific activities. The find_best_days tool evaluates a timeframe and returns a ranked list of auspicious dates. For bulk queries, get_calendar_range pulls calendar spans with filters for custom fortune markers.
The service operates as a hosted remote HTTP endpoint at https://shirabe-calendar--r-yoshikawa.run.tools. Because all computations run on that remote endpoint, any network outage or URL unavailability breaks calendar lookups immediately.
What it helps with
- inspect calendar fortunes and Rokuyo markers for a target date
- rank the most auspicious dates for weddings, moves, or business launches
- filter a multi-week calendar period by favorable sign types
Example prompts for the agent
- Is November 15 a lucky day for a wedding according to the Japanese calendar?
- Find the three best days to move to a new apartment next month
- List all Taian dates scheduled for April
How to install Shirabe Calendar API
Platform CLI: remote server
claude mcp add --transport http shirabe-calendar https://shirabe-calendar--r-yoshikawa.run.toolsPlatform CLI: remote server
codex mcp add shirabe-calendar-api --url https://shirabe-calendar--r-yoshikawa.run.toolsConfig file
{
"mcpServers": {
"shirabe-calendar-api": {
"url": "https://shirabe-calendar--r-yoshikawa.run.tools"
}
}
}Config file
{
"servers": {
"shirabe-calendar-api": {
"type": "http",
"url": "https://shirabe-calendar--r-yoshikawa.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http shirabe-calendar-api https://shirabe-calendar--r-yoshikawa.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Shirabe Calendar API
How to install Shirabe Calendar API in Claude Code?
Run claude mcp add --transport http shirabe-calendar-api https://shirabe-calendar--r-yoshikawa.run.tools in your terminal.
What tools are included in Shirabe Calendar API?
It provides get_japanese_calendar for single-day fortunes, find_best_days for ranked date selection, and get_calendar_range for filtered multi-day queries.
Does this MCP server require local environment dependencies?
No local runtime setup is needed because the client connects straight to the remote HTTP URL https://shirabe-calendar--r-yoshikawa.run.tools.