Hive Intelligence home
Hive Intelligence
GitHub

Install in Your AI Client

Connect Hive to Gemini CLI

Add Hive to Gemini CLI and Google's terminal agent can query live crypto data without wrapper code. Works in Gemini CLI's settings.json MCP block.

Before you start

  1. Gemini CLI installed — follow Google's setup guide.
  2. A free Hive API key from /dashboard/keys.

30-second setup

1. Open the Gemini CLI config

Gemini CLI reads settings from ~/.gemini/settings.json. Create it if it doesn't exist.

2. Add Hive to the MCP block

{
  "mcpServers": {
    "hive": {
      "command": "npx",
      "args": ["-y", "hive-intelligence@latest"],
      "env": {
        "HIVE_API_KEY": "YOUR_HIVE_API_KEY"
      }
    }
  }
}

Replace YOUR_HIVE_API_KEY with your key from /dashboard/keys. If you already have other MCP servers configured, merge the hive entry into the existing mcpServers object.

3. Restart Gemini CLI

Exit any running Gemini CLI session and start a new one. The Hive MCP server will be registered on launch.

4. Verify it worked

Start a new Gemini CLI session and ask:

"Using the Hive MCP server, what is the current price of BTC, ETH, and SOL?"

Gemini should call Hive's get_price tool and return live data.

What to ask once connected

Gemini CLI is strong at multi-step terminal workflows:

  • "Build a shell script that polls BTC funding rates from Hive every 15 minutes and writes to a CSV."
  • "Pull top 20 DeFi pools by APY on Arbitrum right now and render them as a markdown table."
  • "Check this wallet address for today's P&L and summarize in one paragraph: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
  • "Scan these 5 token addresses for honeypot flags and return a safe/unsafe verdict per address."

Gemini's long context window lets it process large tool responses in a single turn — useful for wallet history or DeFi pool surveys.

Troubleshooting

Gemini doesn't list Hive. Confirm ~/.gemini/settings.json is valid JSON. Malformed JSON silently disables all MCP servers. Use cat ~/.gemini/settings.json | jq to validate.

"npx: command not found". Install Node.js 18+ from nodejs.org.

API key rejected. Verify at /dashboard/keys. Keys are sensitive to leading/trailing whitespace.

MCP servers not appearing across sessions. Some shells don't propagate environment changes to new Gemini CLI processes. Restart your terminal or reload your shell profile.

Other clients

Next steps

Previous
VS Code
Next
MCP Integration