Job Desk

A job-search tracker that runs on your own computer. Every job you're looking at or have applied to is one record: the posting, where the application stands, the emails, and what to do next. There's a dashboard for you and an MCP server for Claude, and both work on the same database, so whatever Claude changes shows up on the dashboard within a second.

I built it for my own job search, after a folder of Markdown files and a status table stopped keeping up.

Download

Windows: get JobDesk-…-windows.zip from Releases, unzip it anywhere and double-click JobDesk.exe. The dashboard opens in your browser at http://127.0.0.1:8780. Keep the console window open while you use it, and close it to stop. No Python or Node needed.

Windows may say the app is from an unknown publisher, because it isn't code-signed. Choose More info → Run anyway.

Your data stays in %APPDATA%\JobDesk: the database, attached screenshots, backups and settings.json. Nothing leaves your computer. The server only listens on 127.0.0.1 and has no login. To update, replace the folder; the data isn't in it.

On macOS or Linux, run it from source.

Related MCP server: job-tracker

The dashboard

• Today: what's due, replies waiting, drafts ready to send, interviews coming up, saved jobs closing soon and new jobs to look at.

• Jobs: every job, with search and filters (status, country, city, work mode, visa, priority, source and more). The buttons above the list switch between All, Not applied, In progress and Closed. Each card's tag shows where the job stands: applied, rejected after a screening call, two follow-ups sent, and so on. Click a job to see the posting, its emails, interviews and history.

• Stars: click the star on any card to mark the jobs you care about. Starred jobs sort to the top.

• Stats: the funnel from applied to offer, broken down by source, country and resume version, plus applications per week.

• People: companies and contacts.

A job moves new → shortlisted → drafting → applied → screening → interviewing → offer, and closes as rejected, role filled, no response (their side) or accepted, withdrew, declined (yours). Follow-ups are suggested 7 business days after applying and again 7 later, never more than two. After 30 days of silence it suggests closing the job as no response. It never moves a status on its own.

Working with Claude

Job Desk includes an MCP server, so Claude can read and update your jobs. Every change it makes is validated, shows up live on the dashboard with a toast, and goes on the job's timeline.

With the download, add JobDesk.exe mcp as an MCP server. In Claude Code:

claude mcp add jobdesk -- "C:\path\to\JobDesk\JobDesk.exe" mcp

In Claude Desktop, add this to %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "jobdesk": { "command": "C:\\path\\to\\JobDesk\\JobDesk.exe", "args": ["mcp"] }
  }
}

Running from source, Claude Code picks up .mcp.json in this folder on its own.

Things to ask:

• "Add this job", with a screenshot, pasted text or a link. Claude stores the posting word for word, attaches the screenshot and writes notes on fit.

• "Draft an application for #50." With a Gmail connector, Claude can save it to your Gmail drafts too.

• "Sync my Gmail." Claude reads your sent applications and replies and updates each job.

• "What's due?", "Which UAE jobs sponsor visas?", "Star the Acme one."

Settings

settings.json sits next to the database (%APPDATA%\JobDesk\settings.json, or data/settings.json from source). Everything in it is optional. It's read on every use, so edits apply straight away.

{
  "name": "Ada Lovelace",
  "email_addresses": ["ada@example.com"],
  "resumes": {
    "general": "C:/Users/ada/Resume/resume.pdf",
    "research": "C:/Users/ada/Resume/research.pdf"
  },
  "old_resumes": "C:/Users/ada/Resume/old",
  "email_guide": "C:/Users/ada/Documents/email-guide.md"
}

Run from source

You need Python 3.12+ and Node 20+.

pip install -e ".[dev]"
cd web; npm ci; npm run build; cd ..
python -m jobdesk launch          # serves the dashboard on http://127.0.0.1:8780 and opens it

Data goes in data/ in this folder. Set JOBDESK_HOME to keep it somewhere else.

Other commands: python -m jobdesk today prints what's due, search <words> searches jobs, and backup <label> copies the database into backups/.

Development

python -m jobdesk serve --reload    # API on 127.0.0.1:8780, restarts on code changes
cd web; npx vite                    # dashboard on 127.0.0.1:5180, hot reload
python -m pytest tests              # tests
cd web; npx tsc --noEmit            # type check

start.ps1 starts both dev servers in their own windows and opens the dashboard. AGENTS.md has the details for coding agents: where things are, the rules for the data and how schema changes work.

The backend is FastAPI and SQLite, and the MCP server uses the official Python SDK. The dashboard is React, TypeScript and Vite. core.py is the only code that writes to the database, so the dashboard, Claude and the CLI all get the same validation, duplicate checks and timeline.

To build the Windows zip, run packaging/build.ps1. It makes its own clean Python environment in .venv-build, since PyInstaller bundles anything it can import. Pushing a tag like v1.0.0 builds it on GitHub Actions and publishes a release.

License

MIT