job-search-mcp
Sends notifications for high-scoring new jobs via Telegram.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Try the demo · Quick start · Claude Code, Codex, any MCP client · REST API · Compare · Docs
How a day goes
Every new job, filtered, prepared and ranked.
Openings brings in fresh jobs from your searches and watched companies, on your schedule. Repeats are left out and likely copies flagged.
Your agent decides and prepares. Your agent reads each job by your rules, dismisses with a reason and writes a CV and letter for the rest.
You apply, best first. Ready is ranked by priority, then deadline. You send each one yourself.
Change a line in your Preferences, and your agent's next decisions change with it:
Preferences › What I'm looking for | Jobs › Dismissed |
"…or remote within Europe." | "Dismissed by Claude Code · On site in London five days a week; you look for … remote within Europe." |
Related MCP server: Jobs MCP Server
What Openings holds
You set these up once, by hand or with your agent.
Profile. Your career entries and highlights. ★ means always in your CV, and only approved highlights are used.

Preferences. Five sections in your own words: What I'm looking for, What I rule out, Facts about me, Writing rules (for the CV, the letter or both) and Working with me.

Templates. Your own TeX for the CV and the letter, with a Preview and Limits on pages, bullets per entry and bullet length.

Sources. LinkedIn, Indeed and Glassdoor searches (no login), careers pages on 12 hiring platforms, Hacker News, RSS feeds and job links. Each shows found · ever shortlisted · applied, to tune over time.

After you apply
Today shows what is ready to send, what needs attention and what waits for a reply. Openings tracks replies, follow-ups and deadlines, and your agent briefs you before each interview, with a debrief saved after it.

Quick start
Look first
A disposable workspace of fictional data. It contacts no job site, is deleted when it stops, and prints a sign-in link, an agent token with its export line and the lines that connect Claude Code and Codex:
docker run --rm -p 127.0.0.1:8080:8080 vincenzoimp/openings demoUse it
One command keeps your workspace in the openings volume:
docker run -d --name openings -p 127.0.0.1:8080:8080 -v openings:/data --read-only --tmpfs /tmp --restart unless-stopped vincenzoimp/openings:latestOr Docker Compose v2, in a folder of its own, with resource limits and the minor release pinned:
curl -fsSLO https://raw.githubusercontent.com/VincenzoImp/openings-job-search/main/docker-compose.yml && docker compose up -dOpen http://127.0.0.1:8080, enter the one-time setup code from the log and choose an owner password. The setup guide takes it from there.
docker logs openings # with docker run
docker compose logs openings # with Docker ComposeMap another host port and name the address agents and upload links use, or with Compose set OPENINGS_PORT:
docker run -d --name openings -p 127.0.0.1:18080:8080 -v openings:/data \
-e OPENINGS_PUBLIC_URL=http://127.0.0.1:18080 \
--read-only --tmpfs /tmp --restart unless-stopped vincenzoimp/openings:latestOPENINGS_PORT=18080 docker compose up -dOn a server or NAS, publish the port and set the address other devices use; with Compose, in .env:
docker run -d --name openings -p 8080:8080 -v openings:/data \
-e OPENINGS_PUBLIC_URL=http://nas.local:8080 \
--read-only --tmpfs /tmp --restart unless-stopped vincenzoimp/openings:latestOPENINGS_BIND=0.0.0.0
OPENINGS_PUBLIC_URL=http://nas.local:8080Put HTTPS in front before you reach it from outside your home: Operations.
Use it with your agent
In Settings › API & agents, create an agent token and put it in your shell: export OPENINGS_TOKEN=op_.... Then install the Claude Code plugin, with the MCP connection and the skills:
/plugin marketplace add VincenzoImp/openings-job-search
/plugin install openings@openings-job-searchOther clients connect to http://127.0.0.1:8080/mcp/ with the token as a bearer header: Work with an agent. The skills ship with the app:
Skill | Your agent |
| Checks the connection, then records your career entries, Preferences, templates and first sources from your CV and a short interview. |
| Adds, previews, tunes and pauses your searches, company boards and feeds so new jobs fit what you want. |
| Reads new jobs by your Preferences and experience, shortlists fits with a priority and dismisses mismatches with a reason. |
| Writes, compiles and checks a tailored CV and letter for each shortlisted job until the application is Ready. |
| Ranks your open applications by priority, gives each a salary range with its basis and flags employers you apply to too often. |
| Records each reply, interview or rejection you report and tells you what is waiting on you or on an employer. |
| Saves an interview brief on the application, with stories from your record and likely questions, then a debrief after the interview. |
| Triages new jobs, prepares and ranks the shortlist, checks deadlines and replies, and reports back, when you ask or on a schedule. |
| Keeps your Profile, career entries, highlights, templates and Preferences current from a CV or from what you say changed. |
| Takes and checks backups and exports, tidies stale items reversibly, deletes records only when you ask and undoes an agent run. |
| Answers any question and makes any change in your job search, from jobs and applications to your Profile, career entries and Preferences. |
Then ask, in order: "Set up my Openings workspace from my CV.", "Go through my new jobs." and "Prepare CV and letter for my shortlist." Afterwards, "Run my job search" does it all in one go, also on a schedule.
By hand, by REST, by MCP
Every step is one operation, three ways. Shortlisting a job:
By hand | REST | MCP |
In Jobs › New: |
| The |
curl -fsS http://127.0.0.1:8080/api/v1/jobs/triage -H "Authorization: Bearer $OPENINGS_TOKEN" \
-H 'Content-Type: application/json' -d '{"items":[{"job_id":"'"$JOB_ID"'","to":"shortlisted"}]}'{"name": "jobs_triage", "arguments": {"items": [{"job_id": "<JOB_ID>", "to": "shortlisted"}]}}JOB_ID is a job's id from GET /api/v1/jobs?triage=new.
What stays yours
No submission. Nothing in Openings can submit an application or contact an employer.
Attributed writes. Every agent change carries its token's name, and non-destructive changes can be undone.
Deliberate deletes. Records are deleted permanently only when you ask.
Your autonomy dial. Working with me, in Preferences, says what your agent may do on its own.
One SQLite file. Your workspace lives in a Docker volume, with verified daily backups.
No account and no telemetry. Openings contacts only the job sites your sources name.
Any language, any country. Postings, Preferences and documents can be in any language.
Compared
Openings | Huntr, Teal, Simplify | Auto-apply bots | career-ops | |
Runs on your machine | Yes: one container, one SQLite file | No: hosted services | Yes | Yes: in your AI CLI |
AI | Bring your own agent, over MCP | Built in, on paid plans | Built in | Your CLI's agent |
Holds your career, rules and templates | Yes: Profile, Preferences, Templates | A profile and resumes | A profile for forms | Files in your CLI's folder |
Collects from company job boards | 12 platforms, on your schedule | No: a browser extension saves jobs | Not documented | Ashby, Greenhouse, Lever, Wellfound |
Auto-apply | No: you send each one | Autofill; Simplify+ "Autopilot" | Yes: fills and submits forms | No |
career-ops and Openings work well together. More tools, with sources: Openings compared.
Screenshots
FAQ
Which agents work? Any MCP client: Claude Code, Codex, Cursor, Gemini CLI and others.
How is this different from auto-apply? No operation submits an application. You send each one yourself.
Employer bans AI-written applications? Record it as a blocking requirement; the application can't reach Ready until you settle it.
What does it cost? Nothing: MIT-licensed. Your agent costs what your plan costs.
Which sites? LinkedIn anywhere; Indeed and Glassdoor by country; 12 hiring platforms. Missing one? Request a job site.
What if LinkedIn blocks me? A refused site is paused and retried later (details).
Do I need LaTeX? No. Upload PDFs, or your agent compiles with Tectonic.
Prompt injection in postings? Posting text is data: see the security model.
Is it vibe-coded? The rules that matter are enforced in the services and in SQLite, not in prompts, and tests cover each one.
I built Openings for my own job search and use it every day. I built it with AI coding agents, mainly Claude Code: I decide what it does and how it behaves, and every change passes the full test suite before it ships.
What it is not: Openings has one user per installation, no hosted version and no auto-apply.
Status
Pre-1.0 and released often (see the changelog). An upgrade converts your data automatically (Operations); back up first.
Documentation
All guides: docs. Start with How it works, Getting started and Work with an agent.
Project
Bug reports, job-site requests and pull requests are welcome: start with CONTRIBUTING.md and the good first issues. Architecture · Code of conduct · Security · Brand · MIT license
If Openings saves you time, a star helps other job seekers find it.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Public MCP server for discovering open jobs. Search, filter, and get application links.
GetJobzi MCP server for job search, application tracking, and career forecasting.
MCP server for searching Airweave collections with natural language queries.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceUnified job search MCP server that aggregates live listings from multiple job boards with deduplication, enabling AI agents to find and filter jobs by keyword and location.MIT
- AlicenseNot gradedqualityDmaintenanceA custom MCP server that exposes a jobs database to any MCP-compatible LLM client, allowing users to ask in plain English to search, filter, and match job openings.MIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server that exposes job-search and application-management capabilities to compatible AI clients, enabling discovery of vacancies, drafting of tailored application materials, and coordinated human-approved submissions.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that aggregates and deduplicates job listings from multiple public sources, ranks them against a user's resume, and exposes tools for searching, viewing details, explaining fit, and tracking applications.MIT