jobseek-mcp
v0.9.0
Published
JobSeek MCP Server - AI-powered job search automation for Claude. Enables automated job searching with Claude for Chrome browser control.
Maintainers
Readme
JobSeek MCP Server
AI-powered job search automation for Claude. Works with Claude for macOS + Claude for Chrome for fully automated job searching and application assistance.
Features
- 🚀 Automated Job Search - Claude navigates job boards, finds matching roles, and helps you apply
- 📋 Smart Form Filling - Get your profile data ready for any application form
- 🎯 Job Matching - AI-powered scoring to find the best fit roles
- 📄 Resume Optimization - ATS-friendly resume enhancements
Quick Start
Install from npm
npx jobseek-mcpOr install globally:
npm install -g jobseek-mcp1. Generate an API Key
- Go to https://getjobseek.com/dashboard/api-keys
- Click "Generate Key"
- Copy the key (you won't be able to see it again!)
2. Configure Claude
For Claude for macOS / Claude Desktop
Add to your Claude config (~/Library/Application Support/Claude/claude_desktop_config.json on Mac):
{
"mcpServers": {
"jobseek": {
"command": "npx",
"args": ["jobseek-mcp"],
"env": {
"JOBSEEK_API_KEY": "sk_live_your_key_here"
}
}
}
}For Claude Code
Add to ~/.claude.json:
{
"projects": {
"/path/to/your/project": {
"mcpServers": {
"jobseek": {
"type": "stdio",
"command": "npx",
"args": ["jobseek-mcp"],
"env": {
"JOBSEEK_API_KEY": "sk_live_your_key_here"
}
}
}
}
}
}3. Restart Claude
After saving the config, restart Claude. Type /mcp to verify the server is connected.
Available Tools
my_profile
Get your profile information including resume summary, skills, and experience.
get_form_data
Get structured profile data optimized for filling job application forms. Returns:
- Personal info (name, email, phone, location)
- Professional summary and headline
- Skills (as array and comma-separated text)
- Work history formatted for forms
- Education details
- Default cover letter text
Example: "Get my form data for applying to jobs"
evaluate_job
Score a job against your profile. Provide the job title, company, and description to get:
- Match score (0-100%)
- Recommendation (strongly_recommend, recommend, consider, skip)
- Strengths and gaps analysis
- Application strategy
Example: "Evaluate this job for me: [paste job description]"
launch_pad
Open job search tabs across major job boards (LinkedIn, Indeed, Glassdoor, etc.) using your resume to determine search terms.
optimize_resume
Optimize your resume for ATS (Applicant Tracking Systems).
upload_resume
Upload a PDF resume to JobSeek.
analyze_matches
Review your recent job matches from the Chrome extension.
my_applications
Get a list of your job applications with their current status, match scores, and status history with dates.
Example: "Show me my recent applications"
update_application_status
Update the status of a job application. Perfect for tracking application progress from email updates (Gmail parsing).
Parameters:
company(required) - Company name to find the applicationjobTitle(optional) - Job title to match (useful if you applied to multiple roles at same company)status(required) - One of:received,interviewing,rejected,offer,accepted,declineddate(optional) - Date of the status change (YYYY-MM-DD format, defaults to today)notes(optional) - Additional context (e.g., "Interview with Sarah scheduled")
Example: "Update my Acme Corp application to interviewing status - interview scheduled for January 15th with the hiring manager"
Automated Job Search (with Claude for Chrome)
The most powerful feature! Use the /auto_job_search prompt to have Claude:
- Prepare - Fetch your profile and form data
- Search - Navigate to job sites and search for matching roles
- Evaluate - Score each job against your profile
- Present - Show you good matches (65%+ score) and ask for approval
- Apply - Fill out application forms with your data
- Track - Keep count of applied/skipped jobs
Usage
In Claude for macOS with Claude for Chrome installed:
/auto_job_search site:linkedin query:"Senior Software Engineer" location:"Remote"Or simply ask:
"Help me search for jobs on LinkedIn and apply to good matches"
Requirements
- Claude for macOS
- Claude for Chrome extension (for browser control)
- JobSeek MCP configured with your API key
Full Workflow Example
You: "Start an automated job search on LinkedIn for product manager roles"
Claude: [fetches your profile]
"I found your profile. You're a Product Manager with 8 years of experience..."
Claude: [navigates to LinkedIn, searches, finds a job]
"Found: Senior Product Manager at Stripe
Match Score: 87%
Strengths: Product strategy, data analysis, cross-functional leadership
Would you like me to apply to this role?"
You: "Yes, apply"
Claude: [fills out application form]
"I've filled out the application:
- Name: John Doe
- Email: [email protected]
- Resume: [attached]
- Why interested: [drafted response]
Ready to submit?"
You: "Looks good, submit it"
Claude: [submits] "Application submitted! Moving to next job..."Troubleshooting
"1 MCP server failed" error
- Check
/mcpin Claude Code for details - Make sure you have a valid API key
- Try running
npx jobseek-mcpdirectly to test
"Authentication Required" error
- Verify your API key is correct
- Make sure you have a resume uploaded at https://getjobseek.com/dashboard/profile
Development
git clone https://github.com/shawnmitchell/jobseek.git
cd jobseek/jobseek-mcp
npm install
npm run dev # Run with tsx (hot reload)
npm run build # Build for production
npm start # Run production buildLicense
MIT © Shawn Mitchell
