Skip to main content
Glama
not-boring-resume-mcp

not-boring-resume-mcp

by gouzmi

not-boring-resume-mcp

Build Status PyPI Versions

MCP server that renders a YAML CV into a one-page PDF via notboringresume.cloud (local headless Chromium).
Optionnaly it can also generate a cover letter adapted to the resume and the offer.

Installation

Requires uv. First download the browser Playwright uses to render PDFs (one-time):

uvx --from not-boring-resume-mcp playwright install chromium

Claude Code:

claude mcp add not-boring-resume -- uvx not-boring-resume-mcp

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "not-boring-resume": {
      "command": "uvx",
      "args": ["not-boring-resume-mcp"]
    }
  }
}

Related MCP server: mcp-overleaf-server

Usage

Run Claude from a folder that holds your cv.yaml (and, optionally, a cover-letter-template.md). Then call one of the prompts:

  • /mcp__not-boring-resume__tailor_cv — tailor the CV and render cv.pdf

  • /mcp__not-boring-resume__tailor_cv_and_letter — also write and render the cover letter

The offer argument

Both prompts take the job offer as their argument — pass it right after the prompt name, either as plain text (paste the whole job description) or as a URL:

/mcp__not-boring-resume__tailor_cv https://example.com/jobs/data-engineer
/mcp__not-boring-resume__tailor_cv_and_letter <paste the full offer text here>

When you give a URL, the server fetches the page and extracts its visible text before tailoring. The offer is what the CV (and letter) get adapted to, so the more complete it is, the better the result.

Both prompts also accept optional path arguments if your files aren't in the default location: cv_path (defaults to ./cv.yaml) and, for tailor_cv_and_letter, cover_letter_path (defaults to ./cover-letter-template.md).

Results are saved under ./output/[company]/[offer]/ (cv.pdf, the adapted cv.yaml, and, when requested, the cover letter as .md and .pdf).

The cv.yaml file

This is the only required input. You can download a ready-to-edit template from notboringresume.cloud (use the editor there to build one, then save it as cv.yaml), or start from the skeleton below and fill in your own data. Markdown is supported in the free-text fields (description, about.description) — e.g. **bold** and [links](https://...).

profile:
  name: Jane Doe
  position: Data & Software Engineer
  image: >-                              # optional: data:image/jpeg;base64,...
    data:image/jpeg;base64,<...>

contact:
  mail: jane.doe@example.com
  city: Taipei, Taiwan
  linkedin:
    title: LinkedIn
    url: https://linkedin.com/in/jane-doe/
  github:
    title: GitHub
    url: https://github.com/janedoe

skills:
  - categoryName: Data Engineering
    skills:
      - Spark
      - Airflow
      - DBT
  - categoryName: Languages
    skills:
      - Python
      - SQL

certifications:
  - name: AWS Certified Data Analyst Specialty (2021)

languages:
  - name: English
    level: Fluent
  - name: Spanish
    level: Intermediate

about:
  description: >
    Two or three sentences on who you are and what kind of role you're
    after. Markdown is allowed here.

experiences:
  - company: Some Company
    year: May 2021 - Jun 2024
    position: Data Engineer
    description: >-
      - **Achievement** with a measurable outcome.
      - Another bullet describing impact, tools, scale.

education:
  - name: Some University
    location: City, Country
    year: 2015 - 2020
    diplomaName: MSc, Computer Science

projects:
  - name: Side Project
    year: Since 2026
    description: >
      One line on the project and the stack used.

A complete, real-world example lives at examples/cv.yaml.

The cover-letter-template.md file

Only needed for tailor_cv_and_letter. There's no download for this one — write your own. It's a normal Markdown letter where the parts that should be rewritten per offer are wrapped in [[TAILOR: instructions]]example text[[/TAILOR]] markers: the instruction tells the model what to write, and the example text shows the tone/length to match. Everything outside the markers is kept verbatim.

# Subject: Application for [[TAILOR: the job title from the offer]]Data Engineer[[/TAILOR]] Position

Dear Hiring Team,

I am a Data & Software Engineer with five years of experience [...].
[[TAILOR: one sentence speaking directly to THIS company, its scale, mission, or
specific challenges; mirror the tone of this paragraph]]Example sentence about the
company.[[/TAILOR]]

[[TAILOR: a paragraph covering a first angle relevant to the offer (data pipelines,
APIs, cloud). Be specific: name companies, tools, outcomes from the adapted YAML.
Keep the same length and register as this example]]Example paragraph.[[/TAILOR]]

[...]

Best regards,
Jane Doe
jane.doe@example.com

A complete example lives at examples/cover-letter-template.md.

Development

This project uses uv.

uv sync --dev                              # install deps
uv run playwright install chromium         # one-time: browser for rendering/tests
uv run ruff format .                        # format
uv run ruff check .                         # lint
uv run pytest                               # tests

The test suite renders the live default CV from notboringresume.cloud, so it needs network access and will fail if the site is down.

Continuous integration

CI (lint + tests) runs on every pull request and push to main. See .github/workflows/ci.yml for details.

Releasing (publishing to PyPI)

Releases are on-demand and automated with python-semantic-release — trigger the release workflow manually with gh workflow run release.yml --ref main and it bumps the version, tags, and publishes to PyPI from the Conventional Commit history. See .github/workflows/release.yml for the full flow.

Available Tools

4 tools
fetch_offerA

Fetch a job offer from a URL and return its visible text.

Use this when the user gives a link instead of pasting the offer. The page is rendered in a headless browser, so it works on JavaScript-heavy job boards.

Args: url: the job offer URL.

Inputs: url (required). Returns: result

generate_letter_pdfA

Render a cover letter written in Markdown into a clean, classic A4 PDF.

Provide the letter either inline via text, or as an existing Markdown file via letter_path — so the PDF can be produced from a letter that already exists, without composing a new one. Uses the same local Chromium as the CV, so it works on any machine without Word or extra system dependencies. Returns {"path"}.

Args: text: the cover letter in Markdown. Blank lines separate paragraphs; a top-level heading (# Subject: ...) is styled as the light-blue header. letter_path: path to an existing Markdown letter to render instead of text. output_path: where to save the PDF, e.g. output/Acme/backend-dev/cover-letter.pdf.

Inputs: text, letter_path, output_path.

generate_pdfA

Render a YAML CV into a one-page PDF via notboringresume.cloud.

Writes the PDF to output_path and returns {"path", "overflows"}. If "overflows" is True, shorten the YAML and call this tool again.

Args: yaml: the CV content in YAML (already tailored to the job offer). Omit it to render the site's built-in default CV (handy for a quick manual test). output_path: where to save the PDF, e.g. output/Acme/backend-dev/cv.pdf. Defaults to cv.pdf in the current directory. cv_path: path to the original CV YAML. When given, the photo from that file is reattached to yaml before rendering (it was stripped by load_cv).

Inputs: yaml, cv_path, output_path.

load_cvA

Return the CV YAML with its embedded photo removed.

Read the CV through this tool instead of opening the file directly: the photo is a base64 data URI that is huge and useless for tailoring. Work from the returned text; the photo is reattached automatically by generate_pdf.

Args: cv_path: path to the CV YAML.

Inputs: cv_path. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: fetching a job offer, generating a cover letter PDF, generating a CV PDF, and loading CV YAML. No overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (fetch_offer, generate_letter_pdf, generate_pdf, load_cv), using snake_case and clear action verbs.

    Tool Count5/5

    With 4 tools, the server is well-scoped for its purpose (resume/CV generation). Each tool covers a essential step in the workflow without unnecessary extras.

    Completeness4/5

    The tool surface covers the key workflow (fetch offer, load CV, generate CV and letter), but lacks explicit editing or versioning tools. Minor gap, but core functionality is present.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Tailors LaTeX résumés, CVs, and cover letters to job descriptions by injecting truthfully-selected content from a master CV, compiling PDFs, and logging applications.
      11
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables users to tailor a one-page LaTeX CV to a job posting by fetching relevant facts from a YAML file, rendering a LaTeX document from id-based selections, and compiling it to PDF, without wasting tokens on repetitive CV reads or compiler logs.
      MIT