[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [OrbiSearch work email finder](https://spiral.ai/integrations/gemini-cli/orbisearch-work-email-finder)

# How to Use OrbiSearch work email finder in Gemini CLI

Finds a verified work email and returns deliverability details when an address is found. Use it to fill a missing business address; OrbiSearch email verification checks an address you already have.

|  |  |
| --- | --- |
| Model | OrbiSearch work email finder |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.005238 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with OrbiSearch work email finder in Gemini CLI

- Use OrbiSearch work email finder to search for Satya Nadella at microsoft.com. Add the returned result to a local example report, including an unresolved outcome if no address is found.
- Use OrbiSearch work email finder to search for Jensen Huang at nvidia.com. Show the returned address and deliverability details in a local example of our business contact view.
- Use OrbiSearch work email finder to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from OrbiSearch work email finder and tell me what changed since last week.
- Check OrbiSearch work email finder and summarize what you find in three bullet points.

## How to set up OrbiSearch work email finder in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run OrbiSearch work email finder**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "orbisearch/people/email-find",
    "input": {
      "linkedin_url": "<linkedin_url>"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds OrbiSearch work email finder on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## OrbiSearch work email finder tools and prices

- [OrbiSearch · Email finder](https://spiral.ai/tools/alexandria/orbisearch/people/email-find) (Alexandria): $0.005238 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| domain |  | — | Company domain, such as acme.com. Required unless linkedin_url is sent. |
| timeout | 30 to 97 | — | Seconds OrbiSearch may search, from 30 to 97. OrbiSearch's default is 97. |
| last_name |  | — | Family name. Send with domain; at least one name part is needed. |
| first_name |  | — | Given name. Send with domain; at least one name part is needed. |
| linkedin_url |  | — | LinkedIn profile URL. Send alone, instead of a name and domain. |

## What can you do with OrbiSearch work email finder in Gemini CLI?

Add deliverability results to a business contact table in your project. An agent can fill missing work addresses or check existing ones, then display OrbiSearch's verdict and supporting details.

### Repair incomplete business contact records

Find a missing work address for a public business contact, or check an address already recorded. Attach the returned deliverability result to the record.

### Prepare an invited speaker contact sheet

For public business speakers who have agreed to participate, find a missing work email or verify the address supplied. Keep unresolved results visible for the event coordinator.

### Review partner contact data

Complete missing addresses for known public business representatives and check existing addresses before an agreed partner update. Summarize the returned results for review.

### Add email quality details to an internal tool

Show the deliverability result and email provider beside a business address. Use a discovered address when one is missing, or check the address already present.

### Complete a public executive research brief

Look for a verified work address for a named public executive at a known company. Report no address found when the search returns that outcome.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## OrbiSearch work email finder in other agents

- [Amp](https://spiral.ai/integrations/amp/orbisearch-work-email-finder)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/orbisearch-work-email-finder)
- [Claude](https://spiral.ai/integrations/claude-desktop/orbisearch-work-email-finder)
- [Claude Code](https://spiral.ai/integrations/claude-code/orbisearch-work-email-finder)
- [Cline](https://spiral.ai/integrations/cline/orbisearch-work-email-finder)
- [Codex](https://spiral.ai/integrations/codex/orbisearch-work-email-finder)
- [Cursor](https://spiral.ai/integrations/cursor/orbisearch-work-email-finder)
- [Devin](https://spiral.ai/integrations/devin/orbisearch-work-email-finder)
- [dots](https://spiral.ai/integrations/dots/orbisearch-work-email-finder)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/orbisearch-work-email-finder)
- [Gemini](https://spiral.ai/integrations/gemini/orbisearch-work-email-finder)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/orbisearch-work-email-finder)
- [goose](https://spiral.ai/integrations/goose/orbisearch-work-email-finder)
- [Grok](https://spiral.ai/integrations/grok/orbisearch-work-email-finder)
- [Grok Build](https://spiral.ai/integrations/grok-build/orbisearch-work-email-finder)
- [Hermes](https://spiral.ai/integrations/hermes/orbisearch-work-email-finder)
- [Instinct](https://spiral.ai/integrations/instinct/orbisearch-work-email-finder)
- [Manus](https://spiral.ai/integrations/manus/orbisearch-work-email-finder)
- [Muse](https://spiral.ai/integrations/muse/orbisearch-work-email-finder)
- [Muse Code](https://spiral.ai/integrations/muse-code/orbisearch-work-email-finder)
- [n8n](https://spiral.ai/integrations/n8n/orbisearch-work-email-finder)
- [Notion](https://spiral.ai/integrations/notion/orbisearch-work-email-finder)
- [OpenClaw](https://spiral.ai/integrations/openclaw/orbisearch-work-email-finder)
- [opencode](https://spiral.ai/integrations/opencode/orbisearch-work-email-finder)
- [Perplexity](https://spiral.ai/integrations/perplexity/orbisearch-work-email-finder)
- [Raycast](https://spiral.ai/integrations/raycast/orbisearch-work-email-finder)
- [VS Code](https://spiral.ai/integrations/vscode/orbisearch-work-email-finder)
- [Windsurf](https://spiral.ai/integrations/windsurf/orbisearch-work-email-finder)
- [Zapier](https://spiral.ai/integrations/zapier/orbisearch-work-email-finder)

## More Gemini CLI guides

- [OrbiSearch email verification](https://spiral.ai/integrations/gemini-cli/orbisearch-email-verification)
- [Particle advertiser company profile](https://spiral.ai/integrations/gemini-cli/particle-advertiser-company-profile)
- [OrbiSearch company profile](https://spiral.ai/integrations/gemini-cli/orbisearch-company-profile)
- [Particle company and creator identifier lookup](https://spiral.ai/integrations/gemini-cli/particle-company-and-creator-identifier-lookup)
- [Openmart local business search](https://spiral.ai/integrations/gemini-cli/openmart-local-business-search)
- [Particle company and public figure search](https://spiral.ai/integrations/gemini-cli/particle-company-and-public-figure-search)

## Questions about OrbiSearch work email finder in Gemini CLI

**Can Gemini CLI use OrbiSearch work email finder?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run OrbiSearch work email finder like any built-in tool.

**How much does OrbiSearch work email finder cost in Gemini CLI?**

$0.005238 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

**Do I need an Alexandria account to use OrbiSearch work email finder in Gemini CLI?**

No. Spiral runs OrbiSearch work email finder on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up OrbiSearch work email finder in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while OrbiSearch work email finder runs?**

OrbiSearch work email finder runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**How fresh is OrbiSearch email data?**

OrbiSearch documents both finding and validation as checks against live mail servers. These checks do not send an email.

**Does a safe result guarantee delivery?**

No. OrbiSearch checks whether a mailbox exists and accepts mail at verification time; sender restrictions, content filtering, or later mailbox changes can still prevent delivery.

**Can OrbiSearch resolve every catch-all address?**

No. Its documentation explicitly says no verification provider can resolve all catch-all addresses, so a catch-all result can remain inconclusive.

**What details does OrbiSearch return beyond deliverability?**

Its verification enrichment includes flags for disposable addresses, role accounts, and free email providers. A successful work email search includes the same enrichment fields.

**What source-side request limit applies?**

OrbiSearch documents a shared limit of 20 requests per second per account across its email finder, single verification, and bulk verification submission endpoints.

