[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Village reverse email lookup](https://spiral.ai/integrations/gemini-cli/village-reverse-email-lookup)

# How to Use Village reverse email lookup in Gemini CLI

Look up the professional profile associated with an email address. Use it to check the business context behind a published speaker or founder address before preparing an invitation.

|  |  |
| --- | --- |
| Model | Village reverse email lookup |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | Up to $0.017459 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Village reverse email lookup in Gemini CLI

- Use Village reverse email lookup for patrick@collison.ie and render any matched professional profile in this project's guest review screen.
- Use Village reverse email lookup to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Village reverse email lookup and tell me what changed since last week.
- Check Village reverse email lookup and summarize what you find in three bullet points.
- Pull the newest data from Village reverse email lookup and give me the result as a table.

## How to set up Village reverse email lookup 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 Village reverse email lookup**: 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": "village/people/from-email",
    "input": {
      "email": "<email>"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Village reverse email lookup on Spiral, shows the price and runs it.

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

## Village reverse email lookup tools and prices

- [Village · Reverse email lookup](https://spiral.ai/tools/alexandria/village/people/from-email) (Alexandria): Up to $0.017459 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| mode | cached_first, realtime_only | — | cached_first (Village's default) returns a recent stored record and otherwise fetches live. realtime_only always fetches live. |

## What can you do with Village reverse email lookup in Gemini CLI?

Build an event research tool that turns public executive profiles, business email matches, or LinkedIn commentary into speaker briefs. Connect the returned data to the project's review screen so an organizer can assess each invitation.

### Prepare a business conference speaker shortlist

Find public executives in the conference's industry, review their professional profiles and recent LinkedIn commentary, and look up business addresses for invitations. Use reverse lookup to check published addresses supplied by the event team.

### Research guests for a business podcast

Discover founders or executives who fit an episode, prepare a professional background brief, and turn recent posts into interview questions. Find an invitation address or resolve a published address already under consideration.

### Plan a partner webinar

Identify public business leaders at potential partner companies, compare their roles and recent commentary, and prepare a relevant webinar proposal. Look up a business address or check the professional profile behind a published partner contact.

### Prepare expert invitations for an industry report

Find public founders and executives whose roles fit the report, review their backgrounds and recent posts, and draft specific interview requests. Use email discovery or reverse lookup according to whether the research starts with a LinkedIn profile or a published address.

## Overview

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

## Village reverse email lookup in other agents

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

## More Gemini CLI guides

- [Village people search](https://spiral.ai/integrations/gemini-cli/village-people-search)
- [Virginia SCC business entity details](https://spiral.ai/integrations/gemini-cli/virginia-scc-business-entity-details)
- [Village email finder](https://spiral.ai/integrations/gemini-cli/village-email-finder)
- [Virginia SCC business entity search](https://spiral.ai/integrations/gemini-cli/virginia-scc-business-entity-search)
- [Village company search](https://spiral.ai/integrations/gemini-cli/village-company-search)
- [Virginia SCC business filing history](https://spiral.ai/integrations/gemini-cli/virginia-scc-business-filing-history)

## Questions about Village reverse email lookup in Gemini CLI

**Can Gemini CLI use Village reverse email lookup?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Village reverse email lookup like any built-in tool.

**How much does Village reverse email lookup cost in Gemini CLI?**

Up to $0.017459 per run. 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 Village reverse email lookup in Gemini CLI?**

No. Spiral runs Village reverse email lookup on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Village reverse email lookup in Gemini CLI?**

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

**Does Gemini CLI wait while Village reverse email lookup runs?**

Village reverse email lookup runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**How large is Village's professional database?**

Village advertises 775 million professional profiles. That is the advertised database size, rather than a promise that every person has an email address, a complete profile, or recent posts.

**How fresh is Village's data?**

Village reports more than 214 million profiles updated within the last 90 days. That figure describes part of its 775 million profile database, so it does not establish a 90-day refresh schedule for every record.

**Where does Village get professional profile data?**

Village's enrichment documentation identifies HarvestAPI's public LinkedIn data as the source for profiles fetched when they are not already stored. Public LinkedIn data is the stated boundary for that enrichment source.

**Where do email matches come from?**

Village's privacy policy names Apollo.io as a source when someone requests an email address or asks who an address belongs to. Email matching therefore has a different documented source from public LinkedIn profile enrichment.

**Can someone be absent even if they have a LinkedIn profile?**

Yes. Village offers profile removal from search, enrichment, and introductions, with removal taking up to 24 hours after email confirmation.

