Job Outreach MCP Server
Searches for companies on Indeed job board to find potential job opportunities.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Job Outreach MCP Server search for companies matching 'Stripe'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Job Outreach MCP Server
An MCP server for automated job outreach that helps you find companies, discover contacts, generate personalized emails with AI, and track your outreach campaigns.
Features
Tool | Description |
| Find companies from job boards (Indeed) or add manually |
| Add contacts with automatic email pattern generation and SMTP verification |
| Scrape company websites for personalization data using AI |
| Track specific job postings you're applying to |
| AI-powered personalized email generation using Claude |
| Smart scheduling for optimal delivery times (Tue-Thu, 9-11am) |
| Monitor opens, clicks, and replies |
| Automatic follow-up email generation |
| Overview of all your outreach campaigns |
Related MCP server: Cold Email Assistant
Setup
Install dependencies:
npm installConfigure settings:
cp data/config.example.json data/config.jsonEdit
data/config.jsonwith your credentials.Build:
npm run build
Configuration
Edit data/config.json:
{
"smtp": {
"host": "smtp.your-server.com",
"port": 587,
"user": "your-username",
"password": "your-password",
"from_email": "you@example.com"
},
"anthropic_api_key": "sk-ant-...",
"user_profile": {
"name": "Your Name",
"title": "Software Engineer",
"resume_summary": "Your background...",
"linkedin_url": "https://linkedin.com/in/you",
"highlights": ["5+ years experience", "TypeScript expert"]
},
"smart_schedule": {
"timezone": "America/Los_Angeles",
"preferred_days": [2, 3, 4],
"preferred_hours": [9, 10, 11]
},
"followup": {
"enabled": true,
"days_between": 5,
"max_followups": 2
},
"tracking_server": {
"port": 3847,
"base_url": "http://your-server:3847"
}
}Usage with Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on Mac):
{
"mcpServers": {
"job-outreach": {
"command": "node",
"args": ["/path/to/auto-job-application/dist/index.js"]
}
}
}Running the Email Processor
The email processor sends scheduled emails and handles tracking:
npm run processorRun this in the background to automatically send emails at their scheduled times.
Workflow Example
Add a company:
search_companies({ query: "Stripe", source: "manual" })Add a contact:
find_contacts({ company_id: 1, contacts: [{ name: "Jane Doe", title: "Recruiter" }] })Research the company:
research_company({ company_id: 1 })Add job posting (optional):
add_job_posting({ company_id: 1, title: "Senior Engineer", url: "https://stripe.com/jobs/123" })Generate personalized email:
generate_email({ contact_id: 1, job_posting_id: 1 })Schedule delivery:
schedule_email({ email_id: 1, smart_schedule: true })Check status:
check_tracking({ company_id: 1 })Schedule follow-up (if no reply):
schedule_followup({ email_id: 1 })
Architecture
src/
├── index.ts # MCP server entry point
├── processor.ts # Background email processor
├── types.ts # TypeScript types
├── tools/ # MCP tool implementations
│ ├── search-companies.ts
│ ├── find-contacts.ts
│ ├── research-company.ts
│ ├── generate-email.ts
│ ├── schedule-email.ts
│ ├── check-tracking.ts
│ ├── schedule-followup.ts
│ ├── list-campaigns.ts
│ └── add-job-posting.ts
├── services/ # Core services
│ ├── database.ts # SQLite operations
│ ├── config.ts # Configuration loader
│ ├── scraper.ts # Web scraping with Puppeteer
│ ├── email-patterns.ts # Email generation & SMTP verification
│ ├── llm.ts # Claude API integration
│ ├── scheduler.ts # Smart scheduling logic
│ └── smtp.ts # Email sending
└── tracking/
└── server.ts # Open/click tracking webhook serverEmail Tracking
The tracking server provides:
Open tracking: 1x1 pixel embedded in emails
Click tracking: Link wrapping with redirect
Reply webhooks: Endpoint for email provider callbacks
For tracking to work, the tracking server must be accessible from the internet (use ngrok for testing or deploy the processor).
Notes
LinkedIn scraping is not implemented (requires authentication and is against ToS)
Email SMTP verification may be blocked by some mail servers
Smart scheduling picks optimal send times: Tuesday-Thursday, 9-11am recipient timezone
The background processor must be running for scheduled emails to be sent
License
MIT
Available Tools
9 toolsadd_job_postingA
Add a job posting for a company. Use this to track specific roles you're applying to.
Inputs: title (required), company_id (required), url, description.
check_trackingA
Check email tracking status. View opens, clicks, and replies for your outreach emails.
Inputs: status, email_id, company_id, contact_id.
find_contactsB
Find or add contacts at a company. Provide contacts manually with names and titles, and the tool will generate and validate email addresses.
Inputs: company_id (required), roles, contacts.
generate_emailA
Generate a personalized outreach email using AI. Creates a draft email based on contact info, company research, and your profile.
Inputs: contact_id (required), tone, job_posting_id.
list_campaignsB
List all outreach campaigns with their status. Shows companies, contacts, and email threads.
Inputs: limit, status, company_id.
research_companyA
Scrape a company's website and extract mission, products, culture, tech stack, and recent news using AI.
Inputs: company_id (required), url.
schedule_emailB
Schedule an email for delivery. Uses smart scheduling by default to pick optimal send times (Tue-Thu, 9-11am).
Inputs: email_id (required), send_at, smart_schedule.
schedule_followupA
Schedule a follow-up email for an outreach that hasn't received a reply. Automatically generates a contextual follow-up message.
Inputs: email_id (required), days_after.
search_companiesA
Search for companies on job boards or add manually. Use source='manual' to add a specific company by name, or source='indeed' to search job postings.
Inputs: query (required), limit, source.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct stage in the outreach workflow: company discovery, contact finding, research, job tracking, email generation, scheduling, tracking, follow-up, and campaign overview. Even schedule_email and schedule_followup are clearly differentiated by their descriptions.
All tool names follow a consistent verb_noun pattern in lowercase snake_case (e.g., search_companies, schedule_followup). The pattern is predictable and makes the purpose of each tool immediately clear.
Nine tools is well within the ideal range for a focused domain. Each tool serves a clear function and there is no unnecessary bloat or vague utility.
The set covers the core outreach lifecycle: find companies/contacts, research, track opportunities, generate/schedule emails, monitor responses, and follow up. Minor gaps exist (e.g., no explicit contact update/delete), but the essential workflow is complete.
Maintenance
Related MCP Connectors
Auto-Apply That Ends on an Interview. AI job search, tailored resumes, job application tracker.
Find jobs and apply with AI: search jobs, set up Auto Apply from your resume and track applications.
141Job applications done for you: check applications and interviews, get prep, apply to a job by URL.
Tailor resumes, score ATS fit, find hiring leads, and send cold outreach, from your agent.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI-driven job application automation for LinkedIn and SEEK platforms with intelligent cover letter generation, automated application submission, and application tracking management. Supports anti-detection measures and complies with platform usage policies for safe job hunting automation.-
- FlicenseNot gradedqualityDmaintenanceAutomates cold email outreach for job applications by parsing job postings, generating personalized emails using AI, and sending them or saving as drafts in Gmail with resume attachments.1-
- AlicenseBqualityCmaintenanceProvides tools to search & auto-apply to jobs directly on company websites, generate custom resumes, get contacts of recruiters and referrals and track applications easily35447 npm27MIT
- AlicenseNot gradedqualityDmaintenanceEnables users to search for jobs, prefill applications using AI, and automate submissions across major platforms like Lever and Ashby directly from Claude or Cursor. It provides a full suite of tools for managing job queues, profile data, and resumes within a chat interface.37MIT