# Shirabe Calendar API

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 2944 installs
- Author: r-yoshikawa
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/r-yoshikawa/shirabe-calendar
- Updated: 2026-04-14
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/shirabe-calendar-api

## What it 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.

## Requirements
- Remote server: `https://shirabe-calendar--r-yoshikawa.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http shirabe-calendar https://shirabe-calendar--r-yoshikawa.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add shirabe-calendar-api --url https://shirabe-calendar--r-yoshikawa.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "shirabe-calendar-api": {
            "url": "https://shirabe-calendar--r-yoshikawa.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "shirabe-calendar-api": {
            "type": "http",
            "url": "https://shirabe-calendar--r-yoshikawa.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http shirabe-calendar-api https://shirabe-calendar--r-yoshikawa.run.tools
```

## When to use it
- 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
- 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

## Similar
- [PlugRail Japanese Calendar](https://affpapa.org/en/nevibecode/mcp/plugrail-japanese-calendar.md) — MCP server
- [japan-holiday-mcp](https://affpapa.org/en/nevibecode/mcp/japan-holiday-mcp.md) — MCP server · 337 installs
- [calcom-api](https://affpapa.org/en/nevibecode/skills/calcom-api.md) — skill · 1 install
- [japan-seasons](https://affpapa.org/en/nevibecode/mcp/japan-seasons.md) — MCP server · 1010 installs
- [extension-email-calendar-events](https://affpapa.org/en/nevibecode/skills/extension-email-calendar-events.md) — skill · 32500 installs
- [gws-calendar](https://affpapa.org/en/nevibecode/skills/gws-calendar.md) — skill · 64100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
