Hoardo

Hoardo MCP サーバー

Hoardo は、保管しているものを記録します。部屋（地下室、屋根裏部屋、トランクルームなど）にある番号付きの箱、それぞれの箱の中身、荷造り、貸し出し、販売、レンタル、やること、棚卸しのリストを管理できます。

Hoardo MCP サーバーを使うと、Claude、ChatGPT、CursorなどのAIアプリからHoardoを利用できます。テントの場所や箱12の中身を尋ねたり、キャンプ用品を荷造りリストに追加したりすると、あなた自身の箱の情報をもとに回答します。

このリポジトリにはドキュメントとインストール手順のみが含まれています。サーバーのソースコードではありません。サーバーは、以下のアドレスでHoardoがホストしています。

サーバー

アドレス	https://www.hoardo.com/api/mcp
トランスポート	Streamable HTTP
サインイン	HoardoアカウントでのOAuth 2.1
レジストリ名	com.hoardo/hoardo

サインイン

AIアプリはOAuthを使ってHoardoにサインインします。HoardoのサインインはSupabase Authによって実行され、アプリは保護されたリソースのメタデータ（RFC 9728）から検出します。 https://www.hoardo.com/.well-known/oauth-protected-resource/api/mcp。 アプリは自身を登録するため（動的クライアント登録）、どこかにコピーするクライアントIDやキーはありません。Hoardoにサインインして「許可」をタップすると、アプリはあなたとして動作し、アカウントから閲覧できる情報を利用します。

Hoardoアカウントが必要です。hoardo.comで作成してください。

接続した各アプリは、Hoardoの設定 › 接続済みアプリに表示され、いつでも接続を解除できます。

知っておくとよいこと

• 変更はすぐに反映されます。 AIアプリに何かの追加、移動、更新を依頼すると、Hoardoはただちに処理します。読み取り専用の接続はありません。接続したアプリはHoardoの情報を読み取るだけでなく、変更することもできます。読み取り専用のツールにはreadOnlyHint、削除するツールにはdestructiveHintが設定されているため、実行前に確認するアプリはそれに応じた確認を行えます。
• 削除したものや箱は、Hoardoアプリの履歴から復元できます。
• MCPサーバー経由では、部屋やリスト全体を削除できません。
• 持ち物に関するHoardo独自のAIメモはHoardo内に保管されます。 アプリからは見えません。

接続

Claude

1. 設定 › コネクターを開き、カスタムコネクターを追加を選択します。
2. 名前にHoardoと入力し、https://www.hoardo.com/api/mcpを貼り付けて、追加を選択します。
3. 接続を選択し、Hoardoにサインインして、許可を選択します。

Claude Codeの場合：

claude mcp add --transport http hoardo https://www.hoardo.com/api/mcp

その後、Claude Codeで/mcpを実行し、Hoardoにサインインします。

ChatGPT

カスタムMCPサーバーはChatGPTのウェブ版で利用できますが、モバイルアプリでは利用できません。追加できるプランや変更を実行できるかどうかは、OpenAIの判断によります。

1. プラグインに移動して、プラスボタンを選択し、カスタムMCPサーバーを追加を選択します。
2. 名前にHoardoと入力します。接続でhttps://www.hoardo.com/api/mcpを貼り付け、OAuthを選択します。
3. 警告に同意し、プラグインとして作成を選択します。
4. インストールして、Hoardoにサインインし、許可を選択します。チャットで@と入力し、Hoardoを選択します。

Cursor

Hoardoを~/.cursor/mcp.json（またはプロジェクト内の.cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "hoardo": {
      "url": "https://www.hoardo.com/api/mcp"
    }
  }
}

Cursorの設定 › MCPを開き、Hoardoの横にある接続（またはログイン）を選択して、Hoardoにサインインし、許可を選択します。

その他のアプリ

Streamable HTTPとOAuthサインインを使ってリモートMCPサーバーを追加できるアプリであれば、利用できます。https://www.hoardo.com/api/mcpを指定し、求められたらサインインしてください。

ツール

参照：情報を調べるだけです。書き込み：何かを変更します。破壊的：削除する、または元に戻せない形で失われます。

ツール	種類	内容
list_rooms	参照	自分が所有するか、招待されたすべての部屋と、それぞれの箱や物の数を一覧表示します。
search_items	参照	複数の検索語を一度に使って持ち物を検索し、それぞれの場所や登録されているリストを表示します。
get_inventory	参照	計画を立てやすい簡潔な形式で、保管しているすべての物（または1つの部屋の物）を取得します。
get_room	参照	部屋にある箱と、それぞれの箱の番号、名前、場所、物の数を取得します。
get_box	参照	1つの箱と、その中にあるすべての物を取得します。
get_lists	参照	リストと、それぞれの種類、登録されている物の数、チェック済みの数を取得します。
get_list_items	参照	1つのリストに登録されている物と、リストが各物について記録している内容を取得します。
get_rentals	参照	貸し出し用リストにある貸し出し品と、指定した日に貸し出し可能かどうかを取得します。
add_items	書き込み	1回につき最大50個の物を箱に追加します。
update_items	書き込み	物の名前、数量、価格、メモ、カテゴリ、または日付を変更します。
move_items	書き込み	物を、どの部屋にある箱へでも移動します。
put_back_items	書き込み	箱から出ている物（梱包中、貸し出し中、レンタル中）を箱に戻します。
add_box	書き込み	部屋または別の箱の中に箱を追加します。番号が指定されていない場合は、次に使える番号が割り当てられます。
update_box	書き込み	箱の名前、番号、または部屋の中での場所を変更します。
move_boxes	書き込み	中身をすべて含めて、箱を別の部屋または別の箱の中へ移動します。
add_room	書き込み	部屋を追加します。
rename_room	書き込み	部屋の名前を変更します。
create_list	書き込み	Hoardoの物、箱、部屋、および名前を入力した物からリストを作成します。
add_to_list	書き込み	物、箱、または部屋を既存のリストに追加します。
update_list	書き込み	リストの名前、種類、ボタンの表示語を変更するか、公開販売ページに掲載します。
tick_on_list	書き込み	リスト上の物にチェックを付ける（梱包済み、返却済み、販売済み、完了、またはカウント済み）か、チェックを外します。
update_list_entries	書き込み	リストが物について記録する内容（所有者、価格、期限、保証金）を更新します。
count_on_list	書き込み	棚卸しリストにある物を数えます。
use_counted_quantities	書き込み	Hoardoの数量を棚卸しで数えた数量に設定します。
book_rental	書き込み	貸し出し用リストから物を貸し出します。すぐに貸し出すことも、先の日程で予約することもできます。
update_rental	書き込み	貸し出し品を引き渡す、受け取る、期間を延長する、変更する、またはキャンセルします。
remove_from_list	破壊的	物をリストから削除します。そのリストにのみ登録されている物は、リストとともに失われます。
delete_items	破壊的	物を削除します。Hoardoアプリの履歴から復元できます。
delete_boxes	破壊的	箱とその中のすべての物を削除します。Hoardoアプリの履歴から復元できます。

すべてのツールと各ツールの入力スキーマについては、 https://www.hoardo.com/.well-known/mcp/server-card.jsonを参照してください。 Hoardoのサーバーカードは、 https://www.hoardo.com/api/mcp/server-cardにあります。

ヘルプ

• HoardoとAIアプリの接続方法：hoardo.com/connect
• 質問や問題：hoardo.com/contact
• プライバシー：hoardo.com/privacy-policy

ライセンス

このリポジトリのドキュメントは、 Creative Commons Attribution 4.0 International（CC BY 4.0）の下でライセンスされています。Hoardoの名称、マスコット、ワードマークはHoardoに帰属し、このライセンスの対象ではありません。