Are you the author? Sign in to claim
A self-hosted, local-first job application tracker with web and MCP integrations.
Application Tracker is a self-hosted workspace for recording job applications, documents, follow-up actions, contacts, and outcomes. It combines a responsive web interface with optional local and authenticated remote Model Context Protocol (MCP) access.
The application stores its data in SQLite and sends no workspace content to a hosted service. A fresh installation contains no account, sample data, or default password.
Application Tracker does not yet provide OpenID Connect browser login. Local password login always remains available.
admin/admin or another known credential.Read the product contract, architecture, and security model for the complete boundary.
cp .env.example .env
npm ci
npm run dev
Open http://<server-ip>:5173, replacing <server-ip> with an address assigned
to the host. The development server and backend listen on all interfaces for
LAN and container access. Restrict both ports with the host firewall, and never
use Vite as a public reverse proxy.
Generate a setup token with openssl rand -hex 32, place it in .env, and
follow the initial administrator setup. Remove the token
and restart the service after setup succeeds.
Run every local quality gate with:
npm run check
Choose one supported path:
Both guides keep data and secrets outside the checkout. The container example publishes port 3333 on loopback by default; LAN exposure requires an explicit override. Internet exposure requires HTTPS at a trusted reverse proxy.
Before upgrades, create an online backup and follow the backup and restore runbook. Copying a live WAL database file is not a valid backup.
Local clients should follow the stdio guide. Remote clients should follow the authenticated HTTPS guide.
Settings → MCP provides copyable templates for Claude.ai, remote Codex, local Codex, and Claude Desktop. Remote interactive clients use the built-in OAuth flow and the same local username and password as the website; no Authentik or other external identity provider is required.
Fresh workspaces are read-only through MCP. An administrator can enable Read and write under Settings → MCP. The server rechecks this policy on every mutation, including calls made through existing sessions.
After connecting Application Tracker to ChatGPT.com, try prompts such as:
Using Application Tracker, give me a read-only summary of my open
opportunities. Group them by stage and include the end company, agency, role,
salary, rating, work arrangement, and next action. Put overdue actions first.
List only the opportunities I have applied for, meaning records with an applied
date. Sort them by rating from highest to lowest and show the end company,
agency, role, salary, work arrangement, stage, and applied date. Do not change
anything.
Find my open remote or hybrid opportunities rated 4 or 5. Recommend the five I
should focus on next, using the recorded salary, stage, next action, and notes.
Tell me which important fields are missing.
When MCP write access is enabled under Settings → MCP, ChatGPT.com can also create or update records:
Create an opportunity for Senior Product Designer at Example Studio. The agency
is Example Recruitment, the salary is £75,000–£85,000, the rating is 4, and the
work arrangement is hybrid. Use the Prospect stage and leave the applied date
empty. Show me the completed record before making any further changes.
With both Outlook Email and Application Tracker connected:
Check my Outlook Jobs folder for recent job-application messages and reconcile
them with Application Tracker. Store each supported message's stable RFC
Message-ID and Outlook web link as email evidence. Do not create duplicates or
guess when a match is ambiguous, and report any message for which Outlook does
not expose a stable Message-ID.
The repository includes the installable Application Tracker Job Email skill. It teaches compatible AI clients how to reconcile messages from an Outlook Jobs folder with Application Tracker through the server's deterministic match and idempotent email-upsert tools, while stopping when evidence is ambiguous or conflicting.
The skill discovers an already-connected
@softeria/ms-365-mcp-server instance by its live mail-tool capabilities, so
users may name or host it however they choose and may use HTTP or stdio
transport. The workflow requires a stable internetMessageId, attachment
metadata, and bounded download tools. Agents must not silently install or
launch a second M365 server when no compatible tool surface is attached.
Codex discovers the skill from .agents/skills while working in this checkout.
Other clients that support SKILL.md skills can install the
.agents/skills/application-tracker-job-email directory using their normal
skill installation flow. Connect both an Application Tracker MCP server and a
Softeria Microsoft 365 MCP server before invoking
$application-tracker-job-email; their local names and URLs do not matter.
Contributions are welcome through pull requests. Read the contribution guide before submitting code. Report suspected vulnerabilities through the private process in the security policy, not a public issue.
Application Tracker is source-available under the Elastic License 2.0. You may use, modify, and redistribute it, but you may not provide the software to third parties as a hosted or managed service that exposes a substantial set of its features.
Run Claude Code as an MCP server so any agent can delegate coding tasks to it
@microsoft✓ OfficialBrowser automation using accessibility snapshots instead of screenshots
@googleapis✓ OfficialGoogle's universal MCP server supporting PostgreSQL, MySQL, MongoDB, Redis, and 10+ databases
@github✓ OfficialOfficial GitHub integration for repos, issues, PRs, and CI/CD workflows