AI Agents
Gemini
Google's assistant, in the Gemini app, in Gemini CLI and in Antigravity.
- Works in
- Gemini, Gemini CLI, and Antigravity
- Connects with
- Sign in, API key, Skill
- Connector
- SPREVA
- Plans
- Gemini app: custom apps for personal Google accounts in the US, in English. Gemini CLI: a paid Gemini API key, Vertex AI or Gemini Code Assist. Everyone else: Antigravity.
Gemini
On gemini.google.com. Once added, SPREVA works in the mobile app too.
Before you start
- A personal Google account, aged 18 or over, in the United States, with Keep Activity on and the Gemini app in English. Work and school accounts can't add custom apps.
Set it up
- 1
On gemini.google.com, open Settings, then Connected Apps. Under Custom apps, choose Add a custom app.
- 2
Paste the SPREVA connector URL and click Next:
URL https://dev-app.spreva.ai/api/mcp - 3
Sign in to SPREVA, choose the workspace and click Allow.
Gemini CLI
In the terminal, for accounts with a paid Gemini API key, Vertex AI or Gemini Code Assist.
Before you start
- Gemini CLI installed, and signed in with a paid Gemini API key, Vertex AI or Gemini Code Assist Standard or Enterprise.
Set it up
- 1
Add SPREVA:
Terminal gemini mcp add --transport http --scope user \ spreva https://dev-app.spreva.ai/api/mcp - 2
Start Gemini CLI and run
/mcp auth spreva. Your browser opens SPREVA: choose the workspace and click Allow.
Also works with
- API key in a header
Send a SPREVA API key as a Bearer token, for automation that runs without a person.
Terminal export SPREVA_API_KEY=POST_API_KEY_... gemini mcp add --transport http --scope user \ spreva https://dev-app.spreva.ai/api/mcp \ --header "Authorization: Bearer $SPREVA_API_KEY" - The CLI and the Agent Skill
Install the
sprevacommand line and its Agent Skill, for agents that work in a terminal.Terminal export SPREVA_API_KEY=POST_API_KEY_... npx -y @spreva/cli skill install --target agents
Antigravity
Google's coding agent, for the free, Google AI Pro and Ultra plans. These steps are for the Antigravity editor.
Before you start
- A SPREVA account, with access to the workspace you want to connect.
- An API key, created in SPREVA under Developer, then API keys.
Set it up
- 1
Create an API key in SPREVA under Developer, then API keys, and copy it.
- 2
In Antigravity, open the menu in the agent panel, then MCP Servers, Manage MCP Servers and View raw config.
- 3
Add SPREVA to the configuration, with your key:
~/.gemini/config/mcp_config.json { "mcpServers": { "spreva": { "serverUrl": "https://dev-app.spreva.ai/api/mcp", "headers": { "Authorization": "Bearer POST_API_KEY_..." } } } } - 4
Save the file, then restart Antigravity or reload its MCP servers.
Also works with
- Connector URL and sign in
Paste the connector URL into the app, sign in to SPREVA and click Allow. No key to keep safe.
~/.gemini/config/mcp_config.json { "mcpServers": { "spreva": { "serverUrl": "https://dev-app.spreva.ai/api/mcp" } } }
Check it works
Start a new conversation and ask:
What's going out this week on SPREVA?
Gemini calls SPREVA's overview tool and answers with the workspace's time zone, what goes out next and anything that needs attention. The first time, Gemini may ask you to allow the tool.
Troubleshooting
There is no Custom apps section in the Gemini app
Custom apps need a personal Google account in the United States, with Keep Activity on and the Gemini app in English. Otherwise, use Gemini CLI or Antigravity.
Gemini CLI stopped reaching SPREVA
The sign-in expired. Run /mcp auth spreva again.
Something else? Troubleshooting covers sign-in loops, plans, limits and time zones.