Job Tracker MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Job Tracker MCP Server show me my pipeline summary"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Job Tracker MCP Server
A Model Context Protocol (MCP) server for tracking job applications and follow-ups, built with FastMCP and SQLite. Lets Claude Desktop, Cursor, or any MCP client log applications, move them through the hiring pipeline, schedule follow-up reminders, and check the health of an active job search through natural conversation.
Features
Log job applications with company, role, applied date, status, job URL, and notes
Move applications through a fixed set of pipeline stages, with validation on transitions
List applications, optionally filtered by status, most recent first
Schedule follow-up reminders tied to a specific application
Query pending follow-ups due on or before a given date, so you can ask "what follow-ups do I have this week"
Mark follow-ups as done
Get a pipeline summary: counts of applications grouped by status
The valid pipeline stages exposed as an MCP resource for client discovery
Related MCP server: JobTrack MCP Server
Tools
Tool | Description |
| Insert a new job application |
| Move an application to a new pipeline status |
| List applications, optionally filtered by status, newest first |
| Schedule a follow-up reminder for an application |
| List follow-ups due on or before a date that are not yet done |
| Mark a follow-up as completed |
| Count applications grouped by pipeline status |
All dates use YYYY-MM-DD format and are validated on input. Valid pipeline stages are: applied, phone_screen, technical_interview, onsite, offer, rejected, withdrawn. Passing any other value to status or new_status raises a clear error.
Resources
pipeline://stages: JSON array of the ordered pipeline stages, so a client can discover valid status values without guessing.
Setup
Requires Python 3.11+ and uv.
uv syncClaude Desktop config
{
"mcpServers": {
"job-tracker": {
"command": "/path/to/job-tracker-mcp-server/run.sh"
}
}
}Replace /path/to/job-tracker-mcp-server with the absolute path to this repo.
Storage
Data is stored in a local SQLite database (applications.db, created automatically on first run, gitignored). Override the location with the JOB_TRACKER_DB_PATH environment variable.
Testing
uv run pytestLicense
MIT
Available Tools
7 toolsadd_applicationB
Add a new job application to the tracker.
Inputs: role (required), company (required), date_applied (required), notes, +2 more. Returns: object
add_followupB
Schedule a follow-up reminder tied to an application.
Inputs: application_id (required), follow_up_date (required), note. Returns: object
get_pending_followupsA
List follow-ups due on or before the given date that are not done.
Inputs: as_of_date (required). Returns: Generic wrapper for non-object return types.
list_applicationsA
List job applications, optionally filtered by status, newest first.
Inputs: status. Returns: Generic wrapper for non-object return types.
mark_followup_doneB
Mark a follow-up reminder as completed.
Inputs: followup_id (required). Returns: object
pipeline_summaryA
Return counts of applications grouped by pipeline status.
Inputs: no named parameters. Returns: Generic wrapper for non-object return types.
update_statusB
Update the pipeline status of an existing application.
Inputs: new_status (required), application_id (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct resource and action: application creation/status/list, follow-up creation/listing/completion, and pipeline summary. There is no overlap between the application and follow-up subdomains.
All tool names follow a clear verb_noun pattern with snake_case (e.g., add_application, list_applications, mark_followup_done). The consistency makes the toolset predictable and easy to navigate.
Seven tools is a well-scoped count for a job tracker. Each tool covers an essential operation, and the number feels neither excessive nor sparse for the domain.
The toolset covers the core lifecycle: adding applications, updating status, listing with filters, and follow-up management. It lacks a delete application or update application details, but these are minor gaps that can be worked around.
Maintenance
Related MCP Connectors
Track job applications: find the ones to follow up on, add jobs, update status, notes and steps.
Analyze job listings against your resume, track applications, and generate cover letters.
Track job applications, tailor resumes and draft cover letters from your AI assistant.
Track job applications on a board: let Claude or ChatGPT read and update jobs, interviews, notes.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables users to manage job applications (add, list, update status) through natural language conversations, using Notion as the backend.3MIT
- FlicenseNot gradedqualityDmaintenanceManages job applications, companies, roles, statuses, deadlines, and reminders through natural language queries.-
- FlicenseNot gradedqualityCmaintenanceEnables job-search application tracking through a private application board, managing application facts, stage history, and interview prep documents while leaving summarization and decision-making to the connected agent.-
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to manage a personal job application tracker, allowing users to list, add, update, and delete job applications with company, role, and status details through natural language.-