Docs / Gmail Setup

Scan your job alert emails
for even more matches.

iimjobs, Naukri, Indeed, and Instahyre already send you curated job alerts — they've matched roles to your profile so you don't have to search. With one command, Scout reads those emails and adds every listing to its candidate pool before scoring and applying.

Setup — 60 seconds

1

Run this in your terminal

Open Terminal (or your shell) and paste:

terminal
claude mcp add gmail npx @anthropic-ai/mcp-gmail@latest

This installs the Gmail MCP server into Claude Code. A browser window will open to authenticate your Google account — approve it once and you're done.

2

Restart Claude Code

Close Claude Code completely and reopen it. The Gmail MCP loads on startup.

To confirm it loaded: claude mcp list — you should see gmail in the list.

3

Run Scout as normal

That's it. Run /scout-run as usual. Scout detects Gmail MCP automatically, scans your job alert emails in Phase 1, and adds any new matches to the scoring pool — no extra steps, no configuration.

You'll see a line like 📧 Email alerts   34 roles from iimjobs, naukri_email, indeed_email (18 emails) during the run.

What Scout scans

Scout looks at job alert emails from these senders in your last 7 days of Gmail:

iimjobs
Daily & weekly digests with curated senior roles — Amazon, JP Morgan, American Express, Vodafone, and similar.
~10–15 roles per email
Naukri alerts
Keyword-matched daily alerts. Often surfaces roles not visible on LinkedIn. Company + location + salary when disclosed.
~15–20 roles per email
Indeed alerts
Job alert emails include direct apply links and salary ranges — rare in the India market. Scout uses the direct link.
~1–5 roles per email, with salary
Instahyre / Cutshort
Startup-focused curated alerts. Scout uses a generic parser for any job board alert email it hasn't seen before.
Varies
💡
Use a different email for job boards? Some people use one email for LinkedIn and another for Naukri/iimjobs. If your job board alerts go to a different Gmail account, add it to your application_email field in user-profile.yaml and Scout will check that inbox too.

Privacy

🔒 What Scout reads — and what it doesn't

  • Scout only searches for emails from known job board senders — it never reads your personal inbox, conversations, or attachments.
  • Email content is processed entirely on your machine by Claude Code. Nothing is sent to AgentCo's servers.
  • Gmail MCP authenticates through your existing Google account using OAuth — your password is never exposed.
  • You can remove the Gmail MCP at any time with claude mcp remove gmail and revoke access in your Google Account security settings.

FAQ

Do I need a paid Gmail or Google Workspace account?
No. The Gmail MCP works with any Google account, including free Gmail. You just need to be signed in to Google when you run the install command.
What if I'm not subscribed to job alerts on iimjobs or Naukri yet?
Then Scout simply won't find any alert emails and will skip Group G silently — no error, no disruption to the rest of the run. To get alerts: sign in to iimjobs.com or naukri.com and set up a saved search with your target role and location. You'll start receiving emails within 24 hours.
Will Scout apply to jobs I've already applied to from those emails?
No. Scout checks every email-sourced job against your applied.json history (company + role title pair) before queuing it. Duplicates are silently skipped.
Gmail says it's a "blocked" or "unverified" app — is it safe?
The Gmail MCP is built by Anthropic (the same company that makes Claude). Google shows an "unverified app" warning for any OAuth app that hasn't gone through Google's verification process, including first-party developer tools. It's safe to proceed — this is the same flow used by all local Claude Code integrations.
How do I turn this off without uninstalling everything?
Run claude mcp remove gmail in your terminal, then restart Claude Code. Scout will silently skip email scanning on future runs and note it in the digest footer.