Hoardo

Hoardo MCP server

Hoardo keeps track of what you store: numbered boxes in rooms (a basement, an attic, a storage unit), what's in each box, and your lists for packing, lending, selling, renting, to-dos and stocktakes.

The Hoardo MCP server lets Claude, ChatGPT, Cursor and other AI apps use your Hoardo. Ask where the tent is, what's in box 12, or to put your camping things on a packing list, and the answer comes from your own boxes.

This repository holds documentation and install instructions only. It is not the server's source code. The server is

hosted by Hoardo at the address below.

Server

Signing in

Your AI app signs you in to Hoardo with OAuth. Hoardo's sign-in is run by Supabase Auth, and apps find it through the protected resource metadata (RFC 9728) at https://www.hoardo.com/.well-known/oauth-protected-resource/api/mcp. Apps register themselves (dynamic client registration), so there is no client ID or key to copy anywhere. You sign in to Hoardo, tap Allow, and the app works as you, with what your account can see.

You need a Hoardo account. Make one at hoardo.com.

Each app you connect is listed in Hoardo under Settings › Connected apps, where you can disconnect it at any time.

Good to know

• Changes happen straight away. When you ask your AI app to add, move or update something, Hoardo does it at once. There is no read-only connection: an app you connect can change your Hoardo as well as read it. Tools that only read are marked readOnlyHint, and tools that delete are marked destructiveHint, so apps that ask before acting can do so.
• Deleted things and boxes come back from History in the Hoardo app.
• Rooms and whole lists can't be deleted through the MCP server.
• Hoardo's own AI notes about your things stay in Hoardo. Apps don't see them.

Connect

Claude

1. Open Settings › Connectors and choose Add custom connector.
2. Name it Hoardo, paste https://www.hoardo.com/api/mcp and choose Add.
3. Choose Connect, sign in to Hoardo and choose Allow.

In Claude Code:

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

Then run /mcp in Claude Code and sign in to Hoardo.

ChatGPT

Custom MCP servers work in ChatGPT on the web, not in the mobile app. Which plans can add them, and whether they can make changes, is up to OpenAI.

1. Go to Plugins, select the plus button, then Add custom MCP server.
2. Enter the name Hoardo. Under Connection, paste https://www.hoardo.com/api/mcp and choose OAuth.
3. Accept the warning and select Create as a plugin.
4. Install it, sign in to Hoardo and select Allow. In a chat, type @ and pick Hoardo.

Cursor

Add Hoardo to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{

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

Open Cursor Settings › MCP, choose Connect (or Login) beside Hoardo, sign in to Hoardo and choose Allow.

Other apps

Any app that can add a remote MCP server over Streamable HTTP with OAuth sign-in should work. Give it https://www.hoardo.com/api/mcp and sign in when it asks.

Tools

Read: only looks things up. Write: changes something. Destructive: deletes, or loses something for good.

The full list, with each tool's input schema, is at https://www.hoardo.com/.well-known/mcp/server-card.json. Hoardo's Server Card is at https://www.hoardo.com/api/mcp/server-card.

Help

• Connecting Hoardo to AI apps: hoardo.com/connect
• Questions and problems: hoardo.com/contact
• Privacy: hoardo.com/privacy-policy

License

The documentation in this repository is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0). The Hoardo name, mascot and wordmark are Hoardo's and are not covered by this license.