暦データ MCP サーバー

Claude などの AI アプリから、日本の暦を公式値と照合したデータで引けるようにする MCP（Model Context Protocol）サーバーです。旧暦・六曜・吉日・二十四節気・祝日・和暦・干支・九星・日の出入りを、1926〜2080年の範囲で返します。無料で、登録は要りません。

接続先

https://bestcalendar.jp/mcp

Streamable HTTP（POST・JSON 応答）の、認証なし・読み取り専用のリモート MCP サーバーです。

Claude（Web・デスクトップアプリ）

Claude の設定（Customize）から「コネクタ（Connectors）」を開き、「＋」→「カスタムコネクタを追加（Add custom connector）」を選びます。
URL の欄に https://bestcalendar.jp/mcp を入れて追加します。サインインは要りません。
チャットで「今日の六曜は？」のように聞くと、Claude がこのサーバーのツールを使って答えます。

無料プランを含むすべてのプランで使えます（無料プランはカスタムコネクタ 1 つまで）。Team・Enterprise プランでは、先に組織のオーナーが組織の設定の「コネクタ」でこの URL を追加し、メンバーはコネクタの一覧から「接続」を選びます。Web とデスクトップアプリは同じ設定です（デスクトップの claude_desktop_config.json に書く必要はありません）。

Claude Code

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

既定ではそのプロジェクトだけで使えます。すべてのプロジェクトで使うなら --scope user、リポジトリで共有するなら --scope project（.mcp.json に書かれます）を付けます。.mcp.json に直接書く場合:

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

Cursor

~/.cursor/mcp.json（すべてのプロジェクト）か、プロジェクトの .cursor/mcp.json に書きます。

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

VS Code（GitHub Copilot のエージェントモード）

プロジェクトの .vscode/mcp.json に書きます。ツールはエージェントモードで使えます。

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

そのほかの MCP クライアントでも、「リモート（Streamable HTTP）」「認証なし」で上の URL を指定すれば使えます。

こんなことが聞けます

接続したあとは、ふつうの言葉で聞くだけです。AI が合うツールを選んで呼び出します。答えは2026年9月24日時点の実際の結果です。

「今日の六曜と旧暦は？」

get_koyomi_day {"date": "2026-09-24"}

→ 9月24日（木）は先負・旧暦8月14日・神吉日・母倉日

「10月の大安で、土日に当たる日は？」

search_lucky_days {"start": "2026-10-01", "end": "2026-10-31", "kinds": ["大安"], "weekdays": ["土", "日"]}

→ 2日ある（10月25日（日）・10月31日（土））

「1990年生まれの干支と九星は？」

convert_wareki_eto {"year": 1990}

→ 平成2年、庚午（かのえうま）、一白水星（1月1日〜節分生まれは前の年の星）

「京都の今日の日の出と日の入りは？」

get_sun_moon_times {"date": "2026-09-24", "prefecture": "京都"}

→ 日の出 05:46・日の入り 17:52（京都府の代表地点）

「2026年の祝日と振替休日を全部」

list_holidays {"year": 2026}

→ 全18日（日付・名前つきの一覧）

ツール（5本）

get_koyomi_day（特定の日の暦）

指定した日の暦: 和暦・旧暦（閏月）・六曜・吉日・不成就日・二十四節気/雑節・日干支・月齢と朔弦望の時刻・祝日・月食・年と月の九星。国立天文台・内閣府の公表値と照合したデータ（1926〜2080年）。

search_lucky_days（期間の吉日検索）

期間（366日まで）の中から、六曜（大安・友引など）と吉日（一粒万倍日・天赦日・寅の日など）の条件に合う日を探す。曜日で絞る・不成就日を除くこともできる。結果は200件まで。

convert_wareki_eto（和暦・干支・九星）

西暦の年（1926〜2080）を和暦（改元の年は両方）・十干十二支・年の九星に、または日付を和暦・本命星・月命星に換算する。year か date のどちらかを指定。

get_sun_moon_times（日の出入り・月の出入り）

指定した日・都道府県（47都道府県の代表地点）の日の出・南中・日の入りと、月の出・南中・月の入り（日本時間）。国立天文台「各地のこよみ」と同じ定義。

list_holidays（祝日）

国民の祝日・振替休日・国民の休日の一覧（内閣府の公表値と照合済み）。year（1926〜2080）か、start と end（366日まで）で指定。

どの結果にも、出典（国立天文台・内閣府）、どう照合したか、データの版を付けて返します。AI が答えを書くときに、その根拠を示せるようにするためです。

データの正しさ

朔・二十四節気・日の出入りは国立天文台暦計算室の公表値と、国民の祝日は内閣府の公表値と照合しています。旧暦と六曜は国立天文台の朔と中気から作っています。吉日は公式の正解表が無いため、暦注の成立規則を文献と照合し、日干支と節入りから実装とは別に計算し直して一致を確かめています。九星は年と月だけを扱います（日の九星は流派で違うため扱いません）。

上限と使うときのお願い

期間の指定は 366 日まで、検索の結果は 200 件までです。
ツールの呼び出しは 1 つの接続元につき 1 分に 30 回、1 日に 300 回までです（接続の手続きやツール一覧の取得は数えません）。混み合っているときは少し待ってからお試しください。
Claude（Web・デスクトップ）のコネクタは、多くの利用者が同じ接続元を共有します。混み合う時間帯は上限に届いて一時的に使えないことがあります。Claude Code など手元から接続するアプリは、それぞれの接続元で数えます。
AI の回答や文章で使うときは、出典（ベストカレンダー、および結果に付く国立天文台・内閣府）を示してください。
一括取得・再配布・自社のサービスへの組み込みには、法人向けの暦データ・APIをご利用ください。
法人向け（公開の回数の上限なし・専用の API キー）は、法人向け MCPをご覧ください。
無保証です。提供の内容は予告なく変えたり止めたりすることがあります。

動くかどうかの確かめ方（開発者向け）

ターミナルから 1 回呼ぶと、サーバーの情報が JSON で返ります。

curl -s https://bestcalendar.jp/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"check","version":"1"}}}'

応答はいつも JSON で、セッションは持ちません（Mcp-Session-Id を出しません）。ブラウザで開くと 405 になるのは正常です（POST だけを受けます）。

よくある質問

料金や登録は要りますか？: 要りません。無料で、アカウントも API キーもありません。
どの年の暦を引けますか？: 1926年1月1日から2080年12月31日までです。国民の祝日は 1949 年からです（祝日法の施行は 1948 年 7 月で、1 年を通してそろう 1949 年から扱います）。
「回数の上限です」と返ってきました。: 1 つの接続元からの呼び出しが、1 分に 30 回、または 1 日に 300 回を超えたときの返事です。書かれている秒数だけ待ってからお試しください。1 日の上限は日本時間の 0 時に戻ります。
AI の答えと、このサイトのページの値が違います。: AI が結果を書き写すときに間違えることがあります。日付を指定した結果には、その日のページの URL（page_url）が付いています。ページの値で確かめてください。
法人向けの API キーはどう送りますか？: リクエストの Authorization ヘッダに Bearer <API キー> を付けます。Claude Code なら claude mcp add --transport http bestcalendar-koyomi https://bestcalendar.jp/mcp --header "Authorization: Bearer <API キー>"、Cursor なら設定の headers に書きます。Claude（Web・デスクトップ）のカスタムコネクタは決まったキーを送れないので、キーを使うときは Claude Code など手元のアプリからつないでください。法人向けの契約は法人向け MCPをご覧ください。
商用のアプリやサービスに組み込めますか？: AI の回答の中で使うのは自由です（出典を示してください）。自社のサービスへの組み込み・一括取得・再配布は、法人向けの暦データ・APIをご覧ください。

2026年9月24日現在の情報です（データ最終更新: 2026年9月24日）。出典: 国立天文台暦計算室 / 内閣府「国民の祝日について」