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 | |------|-------------| | search_companies | Find companies from job boards (Indeed) or add manually | | find_contacts | Add contacts with automatic email pattern generation and SMTP verification | | research_company | Scrape company websites for personalization data using AI | | add_job_posting | Track specific job postings you're applying to | | generate_email | AI-powered personalized email generation using Claude | | schedule_email | Smart scheduling for optimal delivery times (Tue-Thu, 9-11am) | | check_tracking | Monitor opens, clicks, and replies | | schedule_followup | Automatic follow-up email generation | | list_campaigns | Overview of all your outreach campaigns |

Setup

1. Install dependencies:

   npm install

1. Configure settings:

   cp data/config.example.json data/config.json

Edit data/config.json with your credentials.

1. 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 processor

Run this in the background to automatically send emails at their scheduled times.

Workflow Example

1. Add a company:

   search_companies({ query: "Stripe", source: "manual" })

1. Add a contact:

   find_contacts({
     company_id: 1,
     contacts: [{ name: "Jane Doe", title: "Recruiter" }]
   })

1. Research the company:

   research_company({ company_id: 1 })

1. Add job posting (optional):

   add_job_posting({
     company_id: 1,
     title: "Senior Engineer",
     url: "https://stripe.com/jobs/123"
   })

1. Generate personalized email:

   generate_email({ contact_id: 1, job_posting_id: 1 })

1. Schedule delivery:

   schedule_email({ email_id: 1, smart_schedule: true })

1. Check status:

   check_tracking({ company_id: 1 })

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 server

Email 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