Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http shirabe-calendar https://shirabe-calendar--r-yoshikawa.run.tools
Open on GitHub

What 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.tools

Step 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open