JobFlow MCP Server

MCP server for JobFlow — AI-powered job application tracker.

Expose your JobFlow database as MCP tools so AI agents can search, add, and update jobs automatically.

Installation

npm install -g @jobflow/jobflow-mcp

Or use with npx (no install required):

npx @jobflow/jobflow-mcp

MCP Client Configuration

Add to your MCP client config file:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "jobflow": {
      "command": "npx",
      "args": ["@jobflow/jobflow-mcp"]
    }
  }
}

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "jobflow": {
      "command": "npx",
      "args": ["@jobflow/jobflow-mcp"]
    }
  }
}

Database Setup

The MCP server reads from and writes to ~/.jobflow/db.json.

Initial export:

1. Open JobFlow extension → Settings
2. Click "Export for MCP"
3. Save the file as ~/.jobflow/db.json

Two-way sync:

• When agents update jobs (status, notes, scores), the changes are saved to ~/.jobflow/db.json
• Open JobFlow → Settings → "Import from MCP" to bring agent changes into the extension

Available Tools

| Tool | Description | |------|-------------| | get_jobs | List all jobs, optionally filtered by status, company, or skills | | add_job | Add a new job to the pipeline | | update_status | Move a job through pipeline stages | | add_note | Add a note to a job | | get_profile | Get your user profile | | score_fit | Score how well a job fits your profile | | get_analytics | Get pipeline stats: job counts, top skills, response rates | | delete_job | Remove a job from the pipeline |

Job Statuses

• saved — Job found but not yet applied
• applied — Application submitted
• interview-hr — HR/Recruiter screen
• interview-tech-intro — Technical intro call
• interview-tech-system — System design interview
• interview-tech-code — Coding interview
• offer — Received offer
• rejected — Application rejected

Examples

// Add a job
await mcp.callTool("add_job", {
  sourceUrl: "https://linkedin.com/jobs/view/123",
  title: "Senior Software Engineer",
  company: "Acme Corp",
  location: "San Francisco, CA",
  skills: ["TypeScript", "React", "Node.js"]
});

// Get all jobs
const jobs = await mcp.callTool("get_jobs", {});

// Get jobs at a specific company
const stripeJobs = await mcp.callTool("get_jobs", {
  company: "Stripe"
});

// Update status
await mcp.callTool("update_status", {
  jobId: 1,
  status: "applied"
});

// Get analytics
const stats = await mcp.callTool("get_analytics", {});

Requirements

• Node.js 18+
• JobFlow browser extension (for database export)

License

MIT