Setup guide
Connect Gemini CLI to RecHound
Use RecHound from Google's Gemini CLI. (The Gemini app can't connect yet.)
Before you start
- Gemini CLI installed.
Steps
No API key needed: you sign in with your RecHound login. It takes about two minutes.
Add RecHound to Gemini's settings
~/.gemini/settings.json and add RecHound under mcpServers:{
"mcpServers": {
"rechound": {
"httpUrl": "https://app.rechound.com/api/mcp"
}
}
}Start the sign-in
gemini and run this command. Your browser opens./mcp auth rechoundSign in to RecHound and allow access
Ask your first question
Back in Gemini CLI, ask "Which accounts aren't reconciled for last month?"
Good to know
Some newer Gemini CLI versions use "url" with "type": "http" instead of "httpUrl". If RecHound doesn't appear in /mcp, check the MCP section of Gemini CLI's documentation for your version.
To change which companies Gemini CLI can see, or to disconnect it, go to Settings → AI Connections in RecHound. It's always read-only, and only sees companies you can see.
Prefer an API key? You can still create one in Settings → AI Connections and use it with tools that can't sign in. Keep it private: anyone with the key can read the companies it allows.
Troubleshooting
The sign-in page doesn't open
Check pop-ups aren't blocked, or copy the sign-in link your assistant shows into your browser.
"You don't have access to that company"
That company wasn't ticked when you allowed access, or your role there doesn't include it. Change the app's companies in Settings → AI Connections.
The assistant can't see RecHound any more
It may have been disconnected in Settings → AI Connections. Connect it again from your assistant and sign in.
"Couldn't confirm your company access with Xero"
Xero was slow to respond. Wait a minute and try again.
"Too many requests"
RecHound limits how many requests an assistant can make each minute. Wait a minute and ask again.