# Job Tracker

> Job Tracker is an open-source MCP server for hiring and recruiting. Local job-search tracker that screens roles, drafts applications and logs interviews. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, self-hosted
- **Website:** https://jobtrackermcp.com
- **Repository:** https://github.com/adamwardecki/job-tracker-mcp
- **MCP Registry name:** io.github.adamwardecki/job-tracker
- **Categories:** hiring and recruiting, productivity
- **Listing updated:** 2026-11-14

## About

The README describes a Claude Code and Hermes Agent plugin built around one principle: fewer, better applications. On a schedule you set, it checks the job boards and careers pages you chose, filters roles by type, location, salary and deal-breakers, verifies each one against the employer's own posting, skips roles you already touched, and prepares tailored applications. A daily report lists new roles awaiting submission, items that need you, interviews, replies and dropped roles with a reason for each drop, plus how many leads each source returned.

The limits are explicit. It writes drafts only for email and LinkedIn, and a hook blocks every send. It submits an application only if you enabled auto-apply during setup or approve that role in the session, and it does not create accounts, enter passwords, solve visible CAPTCHAs, tick consent boxes or fill sensitive personal fields. The README warns it is early and that source adapters may break when job sites change.

Data stays on your machine in a local SQLite database under ~/.job-tracker, in an owner-only folder, with no network listener, token or account. It needs Node.js 22.18 or newer. Commands include setup, sweep, apply, approve, triage, prep, status, board, cover-letter and correct. The registry entry also lists an MCPB bundle for Claude Desktop.

## Features

- **Scheduled role search:** Checks the boards and careers pages you chose, at times you set.
- **Filter with reasons:** Screens by role type, location, salary and deal-breakers and records why a role was dropped.
- **Status tracking:** Tracks roles, interviews and replies in a local database.
- **Daily report:** One short report of new roles, items needing you and interviews.
- **Approval gates:** Submission needs saved auto-apply consent or per-role approval; sends are blocked.
- **Interview prep and cover letters:** Commands for prep from your stories and one-page cover letters.

## Good for

- Run a daily job search without opening each board
- Keep a record of where each application stands
- Prepare for an interview from your own stories
- Draft cover letters and review applications before sending

## Install

### Claude Code (Terminal)

```sh
claude mcp add job-tracker -- npx -y https://github.com/adamwardecki/job-tracker-mcp/releases/download/v0.5.0/job-tracker-0.5.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "job-tracker": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/adamwardecki/job-tracker-mcp/releases/download/v0.5.0/job-tracker-0.5.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "job-tracker": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/adamwardecki/job-tracker-mcp/releases/download/v0.5.0/job-tracker-0.5.0.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "job-tracker": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/adamwardecki/job-tracker-mcp/releases/download/v0.5.0/job-tracker-0.5.0.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "job-tracker": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/adamwardecki/job-tracker-mcp/releases/download/v0.5.0/job-tracker-0.5.0.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "job-tracker": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/adamwardecki/job-tracker-mcp/releases/download/v0.5.0/job-tracker-0.5.0.mcpb"
      ]
    }
  }
}
```

## FAQ

### Does it send applications by itself?

Only if you enabled auto-apply during setup or approve a role in the session. Review first is the default.

### Where is my data stored?

Locally in ~/.job-tracker/tracker.db. Nothing is sent to the plugin's author.

### Does it cost anything?

The site says it is free, with no subscription or paid tier, though your AI provider's charges still apply.

### What do I need to run it?

Claude Code 2.1.295 or newer, or Hermes Agent, and Node.js 22.18 or newer.

### Is Job Tracker free?

Yes. Job Tracker is open source, so you can use and self-host it for free.

### How do I add Job Tracker to Claude Code?

Run this command in your terminal: claude mcp add job-tracker -- npx -y https://github.com/adamwardecki/job-tracker-mcp/releases/download/v0.5.0/job-tracker-0.5.0.mcpb

### What are the best alternatives to Job Tracker?

The closest alternatives to Job Tracker are Ha MCP, Concord MCP, Reactive Resume, note1 and HeyRole.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Reactive Resume](https://ai-powered.com/mcp/reactive-resume): Reactive Resume is an open-source MCP server for hiring and recruiting.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [HeyRole](https://ai-powered.com/mcp/heyrole): HeyRole is a free MCP server for hiring and recruiting.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/job-tracker
