jobctl - job application tracker for developers (MCP)

AI agents keep your job search organized; you review and plan in a clean dashboard.

• Agents write over a remote MCP server (streamable HTTP, OAuth 2.1) at https://app.jobctl.app/mcp
• Humans read at jobctl.app: pipeline board, analytics, interview timeline, CV/cover attachments
• Published in the official MCP Registry as io.github.DmytroRybka/jobctl and listed as a Glama connector (Healthy, tool quality A)

This repo ships the Claude Code plugin/skill, plus a thin stdio bridge (jobctl-mcp) for clients that prefer local stdio servers.

Quick start (Claude Code)

claude mcp add --transport http jobctl https://app.jobctl.app/mcp \
  --header "Authorization: Bearer jc_..."          # token: app.jobctl.app/settings

/plugin marketplace add DmytroRybka/jobctl-claude
/plugin install jobctl@jobctl

Then just talk: "I applied to Bosch as Tech Lead, prio A, due friday" - Claude keeps the tracker current while you interview.

Other MCP clients

Remote (recommended) - any client with streamable HTTP support connects to https://app.jobctl.app/mcp. OAuth 2.1 with dynamic client registration is supported; static bearer tokens (jc_...) work everywhere.

Local stdio server - this repo ships server.mjs, a standalone MCP server (stdio) exposing the same 10 tools, backed by the jobctl.app API:

git clone https://github.com/DmytroRybka/jobctl-claude && cd jobctl-claude
npm install
JOBCTL_TOKEN=jc_... node server.mjs

or via Docker:

docker build -t jobctl-mcp . && docker run -i --rm -e JOBCTL_TOKEN=jc_... jobctl-mcp

The server starts and lists tools without a token (introspection); every tool call requires JOBCTL_TOKEN (create one at app.jobctl.app/settings).

Tools (10)

Tool	What it does
add_application	Create an application from structured fields or a raw string ("Bosch, Tech Lead, prio A, due friday") with deterministic parsing and duplicate detection
list_applications	Filter by status, priority, text query and saved views
get_application	Full detail: timeline, contacts, interviews, attachments
update_application	Status, priority, salary, next action and more
add_note	Append a note to the application timeline
log_interview	Schedule or debrief interviews with attendees and links
get_due	Overdue and upcoming next actions
get_planned	Agenda for today / tomorrow / this week
attach_analysis	Attach a single replaceable company-analysis markdown (max 100 kB)
attach_file	Attach CV or cover letter files (base64)

Privacy and safety

• Your data lives in your account only; full JSON export and GDPR account deletion are built in
• The API is deterministic - no LLM calls server-side; your agent is the AI layer
• Every change is an auditable event with an actor tag (agent / human / system)

License

MIT