Smart Job Apply MCP

smart-job-apply-mcp: MCP Server That Automates Job Applications & Outreach

Autonomous Model Context Protocol (MCP) Server for automated job search, candidate-job matching, form auto-fill, and application submission across 8 major job portals, paired with recruiter outreach via Gmail.

---

🤖 Looking for an MCP server that automates job applications?

smart-job-apply-mcp is the complete solution for AI agents (Claude, ChatGPT, Antigravity, Cursor, Windsurf, Cline) to autonomously discover, filter, and apply to job openings:

• Cross-Platform Job Automation: Searches and applies across LinkedIn, Naukri, Wellfound (AngelList), Indeed, Glassdoor, Hirist, Instahyre, and Cutshort.
• Smart Form Auto-Fill & Resume Upload: Intelligent form answers (CTC, notice period, technical experience) and automated resume PDF submission.
• External ATS Handling: Connects with @playwright/mcp to navigate redirects to enterprise ATS portals (Greenhouse, Lever, Workday).
• Automated Recruiter Outreach: Extracts recruiter emails from job postings and drafts personalized cold pitches with resumes attached via gmail-mcp.
• Duplicate Protection: Persistent SQLite database tracks every submission so you never double-apply.

---

Overview: The Tri-MCP Autonomous Job Hunt Architecture

Applying to hundreds of high-probability job openings manually is exhausting. smart-job-apply-mcp solves this by providing a complete, agent-ready Model Context Protocol (MCP) toolset.

When orchestrated inside Google Antigravity IDE alongside @playwright/mcp and gmail-mcp, it forms a tri-engine autonomous job-hunting machine:

                      +------------------------------------------+
                      |          Google Antigravity IDE          |
                      |       (Autonomous Multi-Agent AI)       |
                      +--------------------+---------------------+
                                           |
         +---------------------------------+---------------------------------+
         |                                 |                                 |
         v                                 v                                 v
+-----------------------+       +---------------------+       +-----------------------+
|  smart-job-apply-mcp  |       |   @playwright/mcp   |       |       gmail-mcp       |
| • 8 Job Portals       |       | • External ATS Portals|     | • 17 Gmail Tools      |
| • Relevance Matching  |       | • Greenhouse/Lever  |       | • Recruiter Outreach  |
| • Resume Auto-Upload  |       | • Workday Multi-step|       | • Cold Pitching       |
| • Honest Smart Fill   |       | • Custom SPAs       |       | • Interview Tracking  |
| • SQLite Tracker      |       | • Live Fallbacks    |       | • Inbox Triage        |
+-----------------------+       +---------------------+       +-----------------------+
         |                                 |                                 |
         +---------------------------------+---------------------------------+
                                           |
                                           v
                       Real Submissions, Confirmations & Interviews

1. smart-job-apply-mcp (Core Automation):
   • High-throughput search and relevance filtering across 8 portals: LinkedIn, Naukri, Wellfound, Indeed India, Hirist, Glassdoor, Instahyre, and Cutshort.
   • Strict Experience Gate: Eliminates over-qualified roles (e.g. 3+ to 5+ year senior/lead/architect roles) for early-career candidates, focusing 100% of effort on high-probability fits.
   • Smart Form Auto-Fill: Intelligently handles text inputs, radio buttons, dropdowns, notice period, CTC, and resume uploads.
   • Honest Answers: Only claims skills you actually possess in your config, answering 0 for unlisted skills rather than inheriting total experience.
   • Persistent Session & Login Guard: Prevents failed guest submissions by checking and prompting for authentications up front.
   • Duplicate Shield: Local SQLite database tracks all applied job URLs across batches and platforms.
2. @playwright/mcp (External ATS Navigator):
   • Handles jobs that redirect away from job boards to third-party enterprise ATS systems (Greenhouse, Lever, Workday, SmartRecruiters, Taleo).
   • Allows agents to inspect custom forms, complete multi-step applications, and navigate back seamlessly.
3. gmail-mcp (Recruiter Outreach & Response Triage):
   • Extracts hiring manager and recruiter emails from job descriptions.
   • Sends customized, professional outreach emails pitching your skills and attaching your resume.
   • Monitors inbox for interview invites, screening calls, and confirmation receipts.

---

Proven Case Study: 450+ Autonomous Applications in a Single Day

In real-world production runs conducted with Google Antigravity, this suite executed end-to-end campaigns:

• 450+ real applications submitted in one single day across major platforms:
  • LinkedIn: 195+ applications
  • Naukri: 180+ applications
  • Indeed: 50+ applications
  • Glassdoor & Company Career Portals: 25+ applications
• Strict Role Relevance: Zero senior roles misapplied. Every role matched the candidate's exact domain (AI/ML/Computer Vision) and experience tier (0–2 years).
• Recruiter Outreach: Candidate contacts extracted from job descriptions were contacted via gmail-mcp, leading directly to scheduled screening calls with resumes attached.

---

8 Supported Platforms

---

User-Friendly Login Management

Job portals reject unauthenticated applications submitted as guests. smart-job-apply-mcp makes authentication seamless:

1. check_login_status

Run at the start of a session or before applying to see which platforms are ready:

{
  "total_checked": 8,
  "logged_in_count": 5,
  "ready_to_apply": true,
  "platforms": {
    "linkedin": { "logged_in": true, "session_type": "persistent_browser_profile", "hint": "Session active and ready" },
    "naukri":   { "logged_in": true, "cookies_count": 147, "hint": "Session active and ready" },
    "hirist":   { "logged_in": false, "hint": "No session found. Run login_account(platform='hirist')" }
  }
}

2. login_account(platform) (or save_session)

Opens a visible browser window directly to the platform's login page.

• Log in manually via OTP, Password, or Google Sign-In.
• The server reactively detects successful login as soon as the page redirects and saves your cookies / persistent profile immediately (no rigid waiting!).

3. Automatic Pre-Apply Check

If you or an AI agent calls apply_job or bulk_apply on a platform without a saved session:

• If auto_login=True (default for apply_job), the browser automatically launches asking you to log in before submitting.
• In bulk_apply, unauthenticated platforms are reported up front with exact instructions on how to log in.

---

Tool Reference

smart-job-apply-mcp Tools

gmail-mcp Tools

---

Installation & Setup

1. Prerequisites

• Python 3.10+ (Python 3.10, 3.11, or 3.12)
• Node.js 18+ (for @playwright/mcp)
• Google Chrome installed on your system (recommended for Google OAuth sign-in)

2. Clone Repository & Install Dependencies

git clone https://github.com/godikemahesh/smart-job-apply-mcp.git
cd smart-job-apply-mcp

# Install dependencies & register global CLI commands
pip install -e .

# Install Playwright browser binaries
python -m playwright install chromium firefox

3. Configure Your Profile

Copy the template configuration to ~/.smart-job-apply-mcp/config.json:

# Windows PowerShell
New-Item -ItemType Directory -Force -Path "$HOME\.smart-job-apply-mcp"
Copy-Item "config.template.json" -Destination "$HOME\.smart-job-apply-mcp\config.json"

# macOS / Linux
mkdir -p ~/.smart-job-apply-mcp
cp config.template.json ~/.smart-job-apply-mcp/config.json

Edit ~/.smart-job-apply-mcp/config.json with your real resume path, contact details, and technical skill years:

{
  "resume_path": "C:\\Users\\YourUser\\Documents\\resume.pdf",
  "name": "Alex Doe",
  "email": "alex.doe@example.com",
  "phone": "+91-9876543210",
  "location": "Bengaluru, India",
  "experience_years": 2,
  "autofill": {
    "gender": "Male",
    "notice_period": "Immediate Joiner",
    "current_ctc": "6",
    "expected_ctc": "12",
    "total_experience": "2",
    "primary_cloud": "AWS",
    "experience": {
      "python": "2",
      "machine learning": "2",
      "pytorch": "2",
      "docker": "2",
      "aws": "2"
    }
  }
}

4. Configure Gmail OAuth (for gmail-mcp)

1. Create a project in Google Cloud Console.
2. Enable the Gmail API in APIs & Services.
3. Configure the OAuth Consent Screen (User Type: External, add your email as Test User).
4. Create an OAuth Client ID (Application Type: Desktop app).
5. Download the JSON credential file and save it as: ~/.gmail-mcp/oauth-keys.json (or ~/.mailbox-mcp/oauth-keys.json).
6. Run authenticate or start the server — the browser will open once to grant permission.

---

MCP Server Configuration

Configuring the servers is effortless. "env" is NOT required because all module imports, paths, and UTF-8 encodings are automatically handled by the server engines.

🌟 Recommended: Direct CLI Commands (Zero Path Edits)

After running pip install -e ., both smart-job-apply-mcp and gmail-mcp are registered globally in your environment. You can paste this exact snippet directly into Google Antigravity IDE (~/.gemini/config/mcp_config.json), Claude Desktop (%APPDATA%\Claude\claude_desktop_config.json), or Cursor / Windsurf:

{
  "mcpServers": {
    "smart-job-apply-mcp": {
      "command": "smart-job-apply-mcp"
    },
    "gmail-mcp": {
      "command": "gmail-mcp"
    },
    "playwright": {
      "command": "npx",
      "args": [
        "-y",
        "@playwright/mcp@latest"
      ]
    }
  }
}

Why no "env" block? Standard setups often clutter configs with PYTHONPATH or PYTHONIOENCODING. smart-job-apply-mcp dynamically discovers its own root directory and configures UTF-8 I/O in Python code, eliminating all unnecessary boilerplate.

---

Alternative: Direct Python Script (Without pip install -e .)

If you prefer pointing directly to the script files without installing them globally:

{
  "mcpServers": {
    "smart-job-apply-mcp": {
      "command": "python",
      "args": ["C:/path/to/smart-job-apply-mcp/server.py"]
    },
    "gmail-mcp": {
      "command": "python",
      "args": ["C:/path/to/smart-job-apply-mcp/gmail_server.py"]
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    }
  }
}

(Tip: Forward slashes / work reliably across Windows, macOS, and Linux without escape issues.)

---

Ways to Use

1. Autonomous AI Agent in Antigravity or Claude

Once configured, you can talk naturally to your AI assistant:

"Check my login status across all platforms, then search for fresh (<3 days) AI/ML Engineer jobs in Hyderabad and Remote. Filter out any roles requiring 3+ or 5+ years of experience. Present the top 10 matches, and if any description lists a recruiter email, prepare a cold outreach draft in Gmail with my resume."

2. Standalone Interactive Terminal Runner (run.py)

No MCP client required! Run directly from the terminal:

python run.py

Menu options:

1. Check login status (verify sessions for all 8 portals)
2. Login to a platform (opens headful browser to log in)
3. Search & Apply for jobs (interactive keyword search, preview, and apply)
4. View application status history (query database)
5. Search only (browse and evaluate matches)

3. Autonomous Groq CLI Agent (agent.py)

Runs an autonomous conversational agent from the terminal using Groq LLM (with multi-key rotation and 0-cost inference):

cp .env.example .env
# Add your GROQ_API_KEYS in .env
python agent.py

---

Troubleshooting & FAQ

1. Why was my application skipped with "Company cap reached"?

bulk_apply enforces a per-company cap (default 2 applications per company) seeded from your history over the past company_window_days. This prevents spamming a single employer with multiple applications.

2. How are CAPTCHAs handled?

When a CAPTCHA or Cloudflare challenge is encountered, the automation halts and logs a notice. In headful mode, you can solve the challenge directly in the browser; the tool then resumes execution.

3. How do I refresh an expired LinkedIn session?

LinkedIn ties sessions to a persistent Chrome profile. Run login_account(platform='linkedin') or select option 2 in python run.py to open the profile, sign in, and complete any 2FA challenge.

---

License

MIT License. Free for personal and commercial use. Contributions and PRs welcome!