Japanese Calendar API

日本の祝日・販促イベント・六曜・暦注・営業日計算 API

祝日・販促向け一般イベント・六曜・旧暦・十干十二支・二十四節気、営業日計算を、ひとつの公開 API で提供します。祝日データは内閣府が公表する「国民の祝日について」CSV を Source of Truth とします。

Docs を見る OpenAPI JSON

Holiday JSON Remote MCP

今日

Today —

—

六曜: —
イベント: —
干支: —
旧暦: —
節気: —

ダウンロード

iCalendar はカレンダーアプリにそのまま購読登録できます。

サンプル

# 公開 API の origin
$ API_ORIGIN=https://api.jp-calendar.com

# 祝日データをまとめて取得
$ curl "$API_ORIGIN/v1/holidays/2026.json"
{
  "2026-01-01": "元日",
  "2026-01-12": "成人の日",
  "2026-02-11": "建国記念の日"
}

# 指定日の祝日判定
$ curl "$API_ORIGIN/v1/holidays/2026-05-03"
{ "date": "2026-05-03", "is_holiday": true, "name": "憲法記念日" }

# 指定日の販促向け一般イベント
$ curl "$API_ORIGIN/v1/events/2026-05-10"
{ "date": "2026-05-10", "events": [
  { "date": "2026-05-10", "id": "mothers-day", "name": "母の日",
    "category": "gift", "rule": "5月第2日曜日" }
] }

# 期間内の営業日数（土日・祝日除く、最大 4000 日）
$ curl "$API_ORIGIN/v1/business-days?from=2026-04-01&to=2026-04-30"
{ "from": "2026-04-01", "to": "2026-04-30", "business_days": 21 }

MCP

AI エージェントからは Streamable HTTP のリモート MCP として POST /mcp を利用できます。祝日・販促イベント・六曜・暦注・営業日計算・日数カウント・連続休暇ブロックを読み取り専用の tools として公開します。

# MCP endpoint
https://api.jp-calendar.com/mcp

MCP のテスト

# サーバー情報を確認
$ curl -s https://api.jp-calendar.com/mcp 
  -H 'Content-Type: application/json' 
  -H 'Accept: application/json, text/event-stream' 
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0.0"}}}'

# tool 一覧
$ curl -s https://api.jp-calendar.com/mcp 
  -H 'Content-Type: application/json' 
  -H 'Accept: application/json, text/event-stream' 
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# tool 呼び出し
$ curl -s https://api.jp-calendar.com/mcp 
  -H 'Content-Type: application/json' 
  -H 'Accept: application/json, text/event-stream' 
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_holiday","arguments":{"date":"2026-05-03"}}}'

AI エージェント設定

Claude Code:

$ claude mcp add --transport http japanese-calendar https://api.jp-calendar.com/mcp

# プロジェクト共有の .mcp.json に保存する場合
$ claude mcp add --scope project --transport http japanese-calendar https://api.jp-calendar.com/mcp

Codex:

$ codex mcp add japanese-calendar --url https://api.jp-calendar.com/mcp
$ codex mcp list

# または ~/.codex/config.toml
[mcp_servers.japanese-calendar]
url = "https://api.jp-calendar.com/mcp"
enabled = true

Cursor:

# .cursor/mcp.json または ~/.cursor/mcp.json
{
  "mcpServers": {
    "japanese-calendar": {
      "url": "https://api.jp-calendar.com/mcp"
    }
  }
}

エンドポイント

祝日
`GET /v1/holidays.json`	全期間の祝日マップ
`GET /v1/holidays.rich.json`	全期間の祝日詳細マップ（分類・曜日・振替元などのメタ情報付き）
`GET /v1/holidays/{year}.json`	年別の祝日マップ
`GET /v1/holidays/{year}.rich.json`	年別の祝日詳細マップ
`GET /v1/holidays/{date}`	指定日（YYYY-MM-DD）の祝日判定
`GET /v1/holidays/{date}/detail`	指定日の祝日判定と、祝日の場合は詳細メタ情報
`GET /v1/holidays/next`	基準日以降で最も近い祝日
`GET /v1/holidays/next/detail`	基準日以降で最も近い祝日を詳細メタ情報付きで取得
期間・計算ユーティリティ
`GET /v1/between`	期間内の祝日配列
`GET /v1/business-days` `POST /v1/business-days`	期間内の営業日数（最大 4000 日）
`GET /v1/day-count`	期間内のカレンダー日数・営業日数・土日数・祝日数（最大 4000 日）
`GET /v1/holiday-blocks` `POST /v1/holiday-blocks`	土日・祝日・任意休業日をつないだ連続休暇ブロック（最大 4000 日）
`GET /v1/business-days/add` `POST /v1/business-days/add`	休業日に当たる分だけ後ろへ繰り越す営業日加算（最大 4000 日）
イベント
`GET /v1/events`	母の日・ブラックフライデーなど販促向け一般イベントの年別一覧
`GET /v1/events/{date}`	指定日の販促向け一般イベント
`GET /v1/events/between`	期間内の販促向け一般イベント（最大 4000 日）
`GET /v1/events/next`	基準日以降で最も近い販促向け一般イベント。分類で絞り込み可能
暦
`GET /v1/rokuyo/{date}`	指定日の六曜（先勝・友引・先負・仏滅・大安・赤口）
`GET /v1/rokuyo/next`	基準日以降で最も近い指定六曜（大安など）
`GET /v1/lunar/{date}`	指定日の旧暦（年月日・閏月フラグ）
`GET /v1/kanshi/{date}`	指定日の十干十二支（年・月・日）
`GET /v1/solar-terms/{date}`	指定日の二十四節気と前後の節気

詳細は Swagger UI または openapi.json を参照してください。

運用

無料で公開しています。祝日データは内閣府「国民の祝日について」CSVを参照しています。