MCP Server
Connect Claude Code, Claude Deskptop, Codex, or ChatGPT to Housecat through Model Context Protocol (MCP).
Housecat provides a Streamable HTTP MCP server at https://home.housecat.com/mcp/housecat to manage its internal Inbox and CRM (contacts, companies, deals) data and config.
Claude Code
Run this command in your terminal:
claude mcp add --transport http --scope user housecat https://home.housecat.com/mcp
Start claude, enter /mcp, and authenticate by following the Housecat sign-in flow. Use /mcp to check the connection and available tools.
Codex CLI
Run this command in your terminal:
codex mcp add housecat --url https://home.housecat.com/mcp
Complete the Housecat sign-in flow.
Run codex mcp list to check the configuration, then start a new codex session. Try asking: “Use Housecat to list my inboxes.”
Claude Desktop
Go to Customize → Connectors → + → Add custom connector and enter:
- Name: Housecat
- Remote MCP server URL:
https://home.housecat.com/mcp
Click Add, then connect and sign in to Housecat.
ChatGPT desktop
Open Settings → MCP servers → Add server and enter:
- Name:
housecat; URL:https://home.housecat.com/mcp/housecat
Save, select Restart, then select Authenticate to sign-in, then complete the Housecat authorization flow. Type /mcp in the composer to check connected servers.
ChatGPT desktop and Codex CLI share MCP configuration on the same host. If you already added the servers with Codex, check the existing entries in Settings before adding them again.
Troubleshooting
Connecting from a remote machine
If you are connecting Claude Code from a remote machine (e.g. over SSH), the OAuth callback redirects to localhost on the remote box and your browser may show:
localhost refused to connect.
Copy the full callback URL from your browser’s address bar and paste it back into Claude Code’s OAuth prompt to complete the flow.
The URL looks like:
http://localhost:55547/callback?code=rkjYXwRCcFYYgoN4vtC2rqxS1BrH_7KO91z_EXAMPLE&state=CDt10uiDksOmNmvaIYfFY1tM_EXAMPLE