MCP server

ベストカレンダー 暦データ

jp.bestcalendar/koyomi

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Japanese calendar data (rokuyo, lucky days, solar terms, holidays, moon, sunrise), 1926-2080.

Website

At a glance

Type

MCP server

Publisher

bestcalendar.jp (verified by the MCP Registry)

Status

Working at last check

Tools

16

Token cost

About 3,630 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http koyomi https://bestcalendar.jp/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.koyomi]
url = "https://bestcalendar.jp/mcp"

Gemini CLI

{"mcpServers":{"koyomi":{"httpUrl":"https://bestcalendar.jp/mcp"}}}

Cursor

{"mcpServers":{"koyomi":{"url":"https://bestcalendar.jp/mcp"}}}

VS Code

{"servers":{"koyomi":{"type":"http","url":"https://bestcalendar.jp/mcp"}}}

Antigravity

agy mcp add koyomi https://bestcalendar.jp/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"koyomi","server_url":"https://bestcalendar.jp/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"koyomi","server_url":"https://bestcalendar.jp/mcp"}

Tools

• add_days ~342 tokens
  日付の N 日後・N 日前、または N 営業日後・前（business: true。土日祝を除く。定休の曜日・お盆・年末年始・個別の指定も可）。基準日は数えない。n が負なら前（締め切りの逆算）。
• answer ~105 tokens
  日本語の質問 1 つ（例: 2027年4月の一粒万倍日はいつ？／2026年10月1日の六曜は？／2027年の夏至の時刻は？／1990年5月23日から20営業日後は？）に、答え・根拠の道具と引数・出典を 1 回で返す。規則で読むので、読めない質問には推測せず「読めませんでした」と聞き方の例を返す。
• check_business_day ~324 tokens
  日付（または 62 日までの期間）が営業日か休みか（理由と祝日名）。1 日だけなら次の営業日・前の営業日も返す。休みの規則は既定で土日祝、定休の曜日・お盆・年末年始・個別の休業日と営業日を指定できる。
• convert_wareki_eto ~97 tokens
  西暦の年（1926〜2080）を和暦（改元の年は両方）・十干十二支・年の九星に、または日付を和暦・本命星・月命星に換算する。year か date のどちらかを指定。
• count_days ~410 tokens
  2 つの日付の間の日数（開始日・終了日を含めるか選べる）と営業日数（土日祝を除く。定休の曜日・お盆・年末年始・個別の休業日と営業日も指定できる）。数え方は /tools/date-calculator と同じ。business_count_start: true のときは営業日数に開始日も数え、既定の false は開始日を数えない（ある月の営業日の数は、start を 1 日・end を末日にして business_count_start: true を指定した値）。
• find_dates ~1119 tokens
  期間（366日まで）の中から、条件に合う日を探す。条件は六曜・吉日（一粒万倍日・天赦日・不成就日 など）・曜日・祝日・土日祝・二十四節気/雑節・新月/満月など・日干支（十干・十二支）。all（すべて）・any（どれか）・none（除く）で組み合わせ、offset_days で「翌日が満月」「前日が祝日」のようなずれも指定できる。例: 2027年の大安の土日で不成就日でない日。
• get_koyomi_day ~90 tokens
  指定した日の暦: 和暦・旧暦（閏月）・六曜・吉日・不成就日・二十四節気/雑節・日干支・月齢と朔弦望の時刻・祝日・月食・年と月の九星。国立天文台・内閣府の公表値と照合したデータ（1926〜2080年）。
• get_koyomi_entity ~139 tokens
  名前（例: 春分の日・土用の丑の日・十五夜・一粒万倍日・戌の日・不成就日・節分・彼岸）から、その年の日付・次はいつ・あと何日・定義・根拠を返す。二十四節気・雑節の名前（例: 秋分・春分・二百十日・春の彼岸入り）でも引ける。year を指定するとその年、from_date（省略時は今日）を指定すると次の日。
• get_moon_events ~115 tokens
  月食（皆既・部分・半影、日本での見え方と時刻）とスーパームーンの一覧。year（1926〜2080）か、start と end（366日まで）で指定。
• get_moon_phases ~119 tokens
  朔（新月）・上弦・望（満月）・下弦の瞬間（日本標準時・秒まで）の一覧。year（1926〜2080）か、start と end（366日まで）で指定。国立天文台の暦要項と照合済み。
• get_old_time ~102 tokens
  日本時間の日時から、その日の明六つ・暮六つ（国立天文台の定義）と、不定時法の刻（暮六つ・暁九つ など）、十二辰刻（丑三つ時 など）を返す。地点は都道府県（省略時は東京都）。
• get_rokuyo_hours ~77 tokens
  指定した日の六曜と、時間帯ごとの吉凶（例: 先勝は午前が吉、赤口は正午前後だけ吉）。暦注の慣行による。
• get_solar_term_times ~127 tokens
  二十四節気の節入りの日時（日本標準時。秒までと、分に四捨五入した値）。立春・春分・夏至・秋分・冬至などが何時何分か。year（1926〜2080）か、start と end（366日まで）で指定。国立天文台 暦要項と照合済み。
• get_sun_moon_times ~114 tokens
  日の出・日の入り・月の出・月の入り・南中の時刻。指定した日・都道府県（47都道府県の代表地点）の日の出・南中・日の入りと、月の出・南中・月の入り（日本時間）。国立天文台「各地のこよみ」と同じ定義。
• list_holidays ~114 tokens
  国民の祝日・振替休日・国民の休日の一覧（内閣府の公表値と照合済み）。year（1926〜2080）か、start と end（366日まで）で指定。
• search_lucky_days ~236 tokens
  期間（366日まで）の中から、六曜（大安・友引など）と吉日（一粒万倍日・天赦日・寅の日など）の条件に合う日を探す。曜日で絞る・不成就日を除くこともできる。結果は200件まで。

Browse

• Calendars

Related MCP servers

• Japan Business Day
  Japan business days & holidays (official Cabinet Office data). Free tool + x402 USDC paid tools.
• Shirabe Japan Data Hub
  Japan data tools for AI agents: calendar (rokuyo), address, name splitting, corporate number lookup
• Sky and Signs — horoscopes and sky calendars
  Daily horoscopes (en/es, 7 days ahead), moon phases, Panchang, solar terms, Maya, Ramadan dates.
• Qimena Qi Men Dun Jia & BaZi
  Qi Men Dun Jia charts, BaZi Four Pillars, best-time ranking and solar terms. Free, no key.
• IranTools (paid)
  Persian and Iranian utilities for agents plus text tooling. Paid via x402 or MPP.
• Calcgrid
  China working-day data, UK bank holidays, IANA time zones and deterministic business deadlines.
• Fengshui Calculator
  Verifiable Chinese calendar & feng shui: BaZi, flying stars, Kua, almanac. SHA-256 replayable.
• PlugRail Japanese Calendar
  Japanese holiday and business-day calculations using official Japan Cabinet Office data.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/jp.bestcalendar/koyomi.svg)](https://aptlynx.net/servers/jp.bestcalendar/koyomi)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents