mnoomnoo/resume-mcp-server

An MCP server that gives Claude (or any MCP client) structured, searchable access to your resume collection — resumes, cover letters, and application materials in .docx, .pdf, .md, or .txt format.
Job seekers accumulate document sprawl fast: multiple resume versions tailored to different roles, cover letter drafts, reference sheets. Manually digging through them to draft a new application is tedious. Point this server at your resume folder and Claude can answer questions like *"which of my resumes highlights Kubernetes experience?"*, *"what achievements have I listed across my backend roles?"*, or *"draft a cover letter drawing from my work at Acme Corp"* — without you pasting anything.
The server parses each document into structured data (contact info, work history, education, skills, side projects) and exposes 20 tools covering full-text search, skill lookup, company and role queries, achievement mining, education search, ATS-style job-match ranking, collection analytics, and more. Files are watched and re-indexed automatically, so edits to your documents are reflected immediately.
---
Features
- **Multi-format parsing** — .docx, .pdf, .md, and .txt documents are parsed into structured data: contact info, work history, education, skills, and side projects.
- **Automatic de-duplication** — resumes for the same person across multiple files (e.g. a .docx and a .pdf of the same resume) are matched by email or name and collapsed to the richest copy, so search and analytics aren't skewed by duplicates.
- **Automatic hot-reload** — a filesystem watcher re-indexes your documents as soon as they change, no server restart needed.
- **Document type inference** — files are automatically classified as resume, cover_letter, application_material, or other based on filename patterns, which can be overridden per category via environment variables.
- **Full-text and structured search** — search whole documents with search_resumes, or filter any entity type (skills, work experience, achievements, side projects, education) with a scoped query, technology, or competency parameter.
- **Three search modes** — and, or, and regex matching, available consistently on every tool that accepts a query-like parameter.
- **Uniform pagination** — every list-style tool returns the same total_count / items / has_more / next_offset / message envelope, with validated limit/offset and a 200-item cap.
- **Unified error shape** — every failure returns {"error": "..."}, so callers only need to check for one shape regardless of which tool they called.
- **Collection analytics** — get_collection_stats and get_skill_frequency surface aggregate counts and cross-resume skill popularity.
- **ATS-style job-match ranking** — list_ranked_resumes scores every resume against a pasted job description (fuzzy skill matching plus keyword coverage) and ranks them best-match-first; match strictness and score weighting are tunable per call.
- **Read-only and safe by construction** — every tool is annotated readOnlyHint / idempotentHint / openWorldHint: false; nothing mutates your files or reaches outside the local document collection.
- **Flexible deployment** — run over stdio or HTTP, standalone or via Docker/Docker Compose with CORS support, configured through environment variables or a .env file.
See MCP Tools below for the full list of tools this exposes. For best extraction quality, see the Resume Formatting Guide.
---
Quick Start
Give Claude structured access to your resume collection. The server parses your documents on startup and exposes 20 tools for searching by name, company, skill, education, side project, or full text, ranking resumes against a job description, plus analytics tools for skill frequency and collection statistics — with automatic hot-reload when files change.
**Try it immediately with the included sample resumes:**