Resume Generator MCP Server

A Model Context Protocol (MCP) server that generates professional PDF resumes using LaTeX templates. Integrates seamlessly with Claude Desktop to create polished resumes from structured data with advanced folder management and organization features.

Features

🎨 9 Professional Templates - Powered by high-quality LaTeX designs
📄 PDF Generation - Professional-grade output via LaTeX Resume API
🔧 MCP Integration - Works directly with Claude Desktop
📝 Structured Data - Easy-to-use JSON schema for resume data
🎯 Customizable - Custom headings, sections, and template selection
💼 Professional Quality - LaTeX-based rendering for crisp, professional results
🤖 AI-Powered - Natural language resume creation through Claude
📁 Folder Management - Create custom folders and organize resumes by job, company, or category
🗂️ Directory Navigation - List and browse your resume collection with built-in file explorer
🛡️ Secure Paths - Built-in path sanitization prevents security issues

Overview

This MCP server acts as a bridge between Claude Desktop and professional resume generation. Simply describe your resume requirements in natural language to Claude, and it will generate a beautifully formatted PDF resume using LaTeX templates. Now with advanced organization features to keep your resumes perfectly organized!

Prerequisites

Node.js (v16 or higher)
Claude Desktop application
Internet connection (for LaTeX Resume API)

Installation

Clone the repository:

git clone https://github.com/yourusername/resume-generator-mcp.git
cd resume-generator-mcp

Install dependencies:
```
npm install
```
Configure Claude Desktop: Add the following to your Claude Desktop MCP settings file:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json
```
{
  "mcpServers": {
    "resume-generator": {
      "command": "node",
      "args": ["path/to/resume-generator-mcp/server.js"]
    }
  }
}
```
Restart Claude Desktop to load the MCP server.

Usage

Once configured, you can use the resume generator directly in Claude Desktop with natural language. The tool is designed to be flexible and intelligent - you can provide your complete work history and let Claude craft the perfect resume for any situation.

How It Works

Share Your Experience - Provide Claude with your complete professional background, education, skills, and achievements
Specify Your Target - Optionally include a job description or mention the type of role you're targeting
Organize Your Resumes - Choose where to save each resume with custom folder structures
Get Tailored Results - Claude will automatically select and highlight the most relevant experiences for your specific goal

Example Requests

Basic Resume Generation

Create a resume for a software engineer with 5 years experience in React and Node.js

Organized Resume with Custom Folder

Generate a resume for a Senior Developer position at Google and save it in a "FAANG-applications/google" folder

Personal History + Target Position + Organization

Here's my background:
- 8 years as a software developer
- Worked at: Microsoft (2018-2021), Google (2021-2023), startup CTO (2023-present)
- Skills: Python, JavaScript, AWS, team leadership, architecture design
- Education: MS Computer Science from MIT
- Led teams of 5-15 people, built systems serving millions of users

I'm applying for this Senior Engineering Manager position at Netflix:
[paste job description here]

Generate a resume that highlights my most relevant experience for this role and save it in "streaming-companies/netflix" folder.

Folder Management

Create a folder structure for organizing my job applications: "job-search-2024/tech-companies" and "job-search-2024/startups"

Show me what resumes I have in my "tech-companies" folder

Template-Specific Generation with Organization

Generate a resume using template 3 for John Doe and save it in the "personal/drafts" folder with the filename "john-doe-senior-dev"

Career Pivot Scenarios with Organization

I have 10 years in finance but want to transition to product management. Here's my experience:
[detailed background]

Create a resume that emphasizes my transferable skills for a Product Manager role at a tech company and save it in "career-transition/product-management" folder.

Smart Organization Features

🗂️ Auto-Folder Creation - Folders are created automatically when generating resumes
📁 Custom Directory Structure - Organize by company, role type, industry, or any system that works for you
🔍 Directory Browser - List contents of any folder to see your resume collection
📊 File Information - View file sizes, creation dates, and organize by metadata
🛡️ Path Security - Built-in sanitization prevents directory traversal and invalid characters

Organization Examples

By Company:

applications/google/
applications/microsoft/
applications/amazon/

By Role Type:

roles/senior-engineer/
roles/tech-lead/
roles/manager/

By Industry:

industries/fintech/
industries/healthcare/
industries/gaming/

By Status:

drafts/
submitted/2024/
archived/old-versions/

Smart Tailoring Features

🎯 Relevance Optimization - Automatically prioritizes experiences that match the target role
📈 Achievement Highlighting - Emphasizes quantifiable results and accomplishments
🔄 Skill Alignment - Matches your skills to job requirements when provided
📝 Professional Formatting - Ensures consistent, ATS-friendly formatting
🎨 Template Selection - Recommends the best template for your industry/role

Claude will automatically structure your information and generate a professional PDF resume tailored to your specific goals, saving it exactly where you want it.

API Reference

Tools Available

`generate_resume`

Generates a PDF resume from structured data with optional folder organization.

Parameters:

resumeData (object): Complete resume information
filename (string, optional): Custom filename for the PDF
folderPath (string, optional): Custom folder path within generated-resumes directory

Example:

{
  "resumeData": {
    /* resume data */
  },
  "filename": "john-doe-senior-engineer",
  "folderPath": "job-applications/tech-companies/google"
}

`create_folder`

Creates a new folder within the generated-resumes directory.

Parameters:

folderPath (string): Folder path to create (supports nested folders)

Example:

{
  "folderPath": "applications/2024/q1"
}

`list_folders`

Lists all folders and files in the generated-resumes directory.

Parameters:

path (string, optional): Specific subdirectory to list

Example:

{
  "path": "applications/tech-companies"
}

`create_resume_template`

Creates a template structure with placeholder data.

Parameters:

templateNumber (integer, 1-9): Template to use as base

Resume Data Structure

{
  "selectedTemplate": 1,
  "basics": {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "phone": "+1-555-0123",
    "website": "https://johndoe.dev",
    "location": {
      "address": "San Francisco, CA"
    }
  },
  "work": [
    {
      "company": "Tech Corp",
      "position": "Software Engineer",
      "location": "San Francisco, CA",
      "startDate": "2022",
      "endDate": "Present",
      "highlights": [
        "Developed web applications using React and Node.js",
        "Led team of 3 developers on key projects"
      ]
    }
  ],
  "education": [
    {
      "institution": "University of California",
      "area": "Computer Science",
      "studyType": "Bachelor of Science",
      "startDate": "2018",
      "endDate": "2022",
      "location": "Berkeley, CA"
    }
  ],
  "skills": [
    {
      "name": "Frontend",
      "keywords": ["React", "TypeScript", "HTML5", "CSS3"]
    }
  ],
  "projects": [
    {
      "name": "Portfolio Website",
      "description": "Personal portfolio built with Next.js",
      "url": "https://johndoe.dev",
      "keywords": ["Next.js", "React", "Tailwind CSS"]
    }
  ]
}

Configuration

File Storage

Generated PDFs are saved to organized directories within:

Windows: %LOCALAPPDATA%\AnthropicClaude\app-{version}\generated-resumes\
macOS: ~/Library/Application Support/AnthropicClaude/app-{version}/generated-resumes/
Linux: ~/.local/share/AnthropicClaude/app-{version}/generated-resumes/

Directory Structure Example

generated-resumes/
├── applications/
│   ├── google/
│   │   ├── john-doe-swe-2024-06-30.pdf
│   │   └── john-doe-senior-2024-06-30.pdf
│   ├── microsoft/
│   └── startups/
├── drafts/
│   └── work-in-progress-2024-06-30.pdf
└── templates/
    └── base-template-2024-06-30.pdf

Troubleshooting

Common Issues

"Method not found" errors:
- Ensure Claude Desktop is restarted after configuration
- Check that the path in claude_desktop_config.json is correct
Connection errors:
- Verify internet connection
- Check if the LaTeX Resume API is accessible
PDF not generated:
- Check the generated-resumes directory permissions
- Ensure the directory exists and is writable
Folder creation errors:
- Verify write permissions in the generated-resumes directory
- Check that folder paths don't contain invalid characters
Path-related issues:
- Folder paths are automatically sanitized for security
- Invalid characters are replaced with underscores
- Directory traversal attempts (../) are automatically blocked

Debug Mode

Enable debug logging by setting the environment variable:

DEBUG=resume-generator node server.js

Development

Project Structure

resume-generator-mcp/
├── server.js              # Main MCP server with folder management
├── package.json           # Dependencies and scripts
├── README.md              # This file
└── generated-resumes/     # Output directory (created automatically)
    └── [organized folders] # Custom folder structure

Dependencies

@modelcontextprotocol/sdk: MCP SDK for server implementation
node-fetch: HTTP client for API requests
fs/promises: File system operations for folder management

Security Features

Path Sanitization: Prevents directory traversal attacks
Input Validation: Validates folder paths and filenames
Scope Limiting: All operations are confined to the generated-resumes directory
Character Filtering: Removes or replaces invalid filesystem characters

Contributing

Fork the repository
Create a feature branch: git checkout -b feature-name
Make your changes and test thoroughly
Submit a pull request with a clear description

Credits

This project is built on top of several amazing open-source projects and services:

LaTeX Resume API

Service: latexresu.me - Professional LaTeX resume generation API
Credits: Thanks to the LaTeX Resume API team for providing the backend service that powers the PDF generation

LaTeX Templates

The beautiful resume templates are based on designs from resumake.io and the broader LaTeX community:

Rensselaer Career Development Center
Byungjin Park - Awesome CV template
Scott Clark - Clean and professional designs
Debarghya Das - Modern resume templates
Xavier Danaux - Classic LaTeX resume styles
Ratul Saha - Contemporary designs
Daniil Belyakov - Minimalist templates
Frits Wenneker - Professional CV templates

Technology Stack

MCP (Model Context Protocol) - Anthropic for the protocol specification
Claude Desktop - Integration platform for AI-powered tools
Node.js - Runtime environment for folder management and file operations
LaTeX - Document preparation system for high-quality typesetting

License

MIT © Andrea Cadonna

Support

🐛 Bug Reports: GitHub Issues
💡 Feature Requests: GitHub Discussions
📧 Contact: andrea.cadonna@gmail.com

Changelog

v2.0.0 - Folder Management Update

✨ NEW: Custom folder organization within generated-resumes directory
✨ NEW: create_folder tool for creating organized directory structures
✨ NEW: list_folders tool for browsing and managing resume collections
✨ NEW: Enhanced generate_resume with folderPath parameter
🛡️ NEW: Path sanitization and security features
📊 NEW: File metadata display (size, date) in directory listings
🗂️ NEW: Auto-creation of folder paths when generating resumes
📁 NEW: Support for nested folder structures
🔍 NEW: Directory navigation and file organization tools

v1.0.0

Initial release
Support for 9 LaTeX templates via LaTeX Resume API
Natural language resume generation through Claude Desktop
MCP server implementation with structured data support
Professional PDF output with customizable templates

Made with ❤️ for the Claude Desktop and MCP community

Resume Generator MCP Server

Features

🎨 9 Professional Templates - Powered by high-quality LaTeX designs
📄 PDF Generation - Professional-grade output via LaTeX Resume API
🔧 MCP Integration - Works directly with Claude Desktop
📝 Structured Data - Easy-to-use JSON schema for resume data
🎯 Customizable - Custom headings, sections, and template selection
💼 Professional Quality - LaTeX-based rendering for crisp, professional results
🤖 AI-Powered - Natural language resume creation through Claude
📁 Folder Management - Create custom folders and organize resumes by job, company, or category
🗂️ Directory Navigation - List and browse your resume collection with built-in file explorer
🛡️ Secure Paths - Built-in path sanitization prevents security issues

Overview

Prerequisites

Node.js (v16 or higher)
Claude Desktop application
Internet connection (for LaTeX Resume API)

Installation

Clone the repository:

git clone https://github.com/yourusername/resume-generator-mcp.git
cd resume-generator-mcp

Install dependencies:
```
npm install
```
Configure Claude Desktop: Add the following to your Claude Desktop MCP settings file:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json
```
{
  "mcpServers": {
    "resume-generator": {
      "command": "node",
      "args": ["path/to/resume-generator-mcp/server.js"]
    }
  }
}
```
Restart Claude Desktop to load the MCP server.

Usage

How It Works

Share Your Experience - Provide Claude with your complete professional background, education, skills, and achievements
Specify Your Target - Optionally include a job description or mention the type of role you're targeting
Organize Your Resumes - Choose where to save each resume with custom folder structures
Get Tailored Results - Claude will automatically select and highlight the most relevant experiences for your specific goal

Example Requests

Basic Resume Generation

Create a resume for a software engineer with 5 years experience in React and Node.js

Organized Resume with Custom Folder

Generate a resume for a Senior Developer position at Google and save it in a "FAANG-applications/google" folder

Personal History + Target Position + Organization

Here's my background:
- 8 years as a software developer
- Worked at: Microsoft (2018-2021), Google (2021-2023), startup CTO (2023-present)
- Skills: Python, JavaScript, AWS, team leadership, architecture design
- Education: MS Computer Science from MIT
- Led teams of 5-15 people, built systems serving millions of users

I'm applying for this Senior Engineering Manager position at Netflix:
[paste job description here]

Generate a resume that highlights my most relevant experience for this role and save it in "streaming-companies/netflix" folder.

Folder Management

Create a folder structure for organizing my job applications: "job-search-2024/tech-companies" and "job-search-2024/startups"

Show me what resumes I have in my "tech-companies" folder

Template-Specific Generation with Organization

Generate a resume using template 3 for John Doe and save it in the "personal/drafts" folder with the filename "john-doe-senior-dev"

Career Pivot Scenarios with Organization

I have 10 years in finance but want to transition to product management. Here's my experience:
[detailed background]

Create a resume that emphasizes my transferable skills for a Product Manager role at a tech company and save it in "career-transition/product-management" folder.

Smart Organization Features

🗂️ Auto-Folder Creation - Folders are created automatically when generating resumes
📁 Custom Directory Structure - Organize by company, role type, industry, or any system that works for you
🔍 Directory Browser - List contents of any folder to see your resume collection
📊 File Information - View file sizes, creation dates, and organize by metadata
🛡️ Path Security - Built-in sanitization prevents directory traversal and invalid characters

Organization Examples

By Company:

applications/google/
applications/microsoft/
applications/amazon/

By Role Type:

roles/senior-engineer/
roles/tech-lead/
roles/manager/

By Industry:

industries/fintech/
industries/healthcare/
industries/gaming/

By Status:

drafts/
submitted/2024/
archived/old-versions/

Smart Tailoring Features

🎯 Relevance Optimization - Automatically prioritizes experiences that match the target role
📈 Achievement Highlighting - Emphasizes quantifiable results and accomplishments
🔄 Skill Alignment - Matches your skills to job requirements when provided
📝 Professional Formatting - Ensures consistent, ATS-friendly formatting
🎨 Template Selection - Recommends the best template for your industry/role

Claude will automatically structure your information and generate a professional PDF resume tailored to your specific goals, saving it exactly where you want it.

API Reference

Tools Available

`generate_resume`

Generates a PDF resume from structured data with optional folder organization.

Parameters:

resumeData (object): Complete resume information
filename (string, optional): Custom filename for the PDF
folderPath (string, optional): Custom folder path within generated-resumes directory

Example:

{
  "resumeData": {
    /* resume data */
  },
  "filename": "john-doe-senior-engineer",
  "folderPath": "job-applications/tech-companies/google"
}

`create_folder`

Creates a new folder within the generated-resumes directory.

Parameters:

folderPath (string): Folder path to create (supports nested folders)

Example:

{
  "folderPath": "applications/2024/q1"
}

`list_folders`

Lists all folders and files in the generated-resumes directory.

Parameters:

path (string, optional): Specific subdirectory to list

Example:

{
  "path": "applications/tech-companies"
}

`create_resume_template`

Creates a template structure with placeholder data.

Parameters:

templateNumber (integer, 1-9): Template to use as base

Resume Data Structure

{
  "selectedTemplate": 1,
  "basics": {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "phone": "+1-555-0123",
    "website": "https://johndoe.dev",
    "location": {
      "address": "San Francisco, CA"
    }
  },
  "work": [
    {
      "company": "Tech Corp",
      "position": "Software Engineer",
      "location": "San Francisco, CA",
      "startDate": "2022",
      "endDate": "Present",
      "highlights": [
        "Developed web applications using React and Node.js",
        "Led team of 3 developers on key projects"
      ]
    }
  ],
  "education": [
    {
      "institution": "University of California",
      "area": "Computer Science",
      "studyType": "Bachelor of Science",
      "startDate": "2018",
      "endDate": "2022",
      "location": "Berkeley, CA"
    }
  ],
  "skills": [
    {
      "name": "Frontend",
      "keywords": ["React", "TypeScript", "HTML5", "CSS3"]
    }
  ],
  "projects": [
    {
      "name": "Portfolio Website",
      "description": "Personal portfolio built with Next.js",
      "url": "https://johndoe.dev",
      "keywords": ["Next.js", "React", "Tailwind CSS"]
    }
  ]
}

Configuration

File Storage

Generated PDFs are saved to organized directories within:

Windows: %LOCALAPPDATA%\AnthropicClaude\app-{version}\generated-resumes\
macOS: ~/Library/Application Support/AnthropicClaude/app-{version}/generated-resumes/
Linux: ~/.local/share/AnthropicClaude/app-{version}/generated-resumes/

Directory Structure Example

generated-resumes/
├── applications/
│   ├── google/
│   │   ├── john-doe-swe-2024-06-30.pdf
│   │   └── john-doe-senior-2024-06-30.pdf
│   ├── microsoft/
│   └── startups/
├── drafts/
│   └── work-in-progress-2024-06-30.pdf
└── templates/
    └── base-template-2024-06-30.pdf

Troubleshooting

Common Issues

"Method not found" errors:
- Ensure Claude Desktop is restarted after configuration
- Check that the path in claude_desktop_config.json is correct
Connection errors:
- Verify internet connection
- Check if the LaTeX Resume API is accessible
PDF not generated:
- Check the generated-resumes directory permissions
- Ensure the directory exists and is writable
Folder creation errors:
- Verify write permissions in the generated-resumes directory
- Check that folder paths don't contain invalid characters
Path-related issues:
- Folder paths are automatically sanitized for security
- Invalid characters are replaced with underscores
- Directory traversal attempts (../) are automatically blocked

Debug Mode

Enable debug logging by setting the environment variable:

DEBUG=resume-generator node server.js

Development

Project Structure

resume-generator-mcp/
├── server.js              # Main MCP server with folder management
├── package.json           # Dependencies and scripts
├── README.md              # This file
└── generated-resumes/     # Output directory (created automatically)
    └── [organized folders] # Custom folder structure

Dependencies

@modelcontextprotocol/sdk: MCP SDK for server implementation
node-fetch: HTTP client for API requests
fs/promises: File system operations for folder management

Security Features

Path Sanitization: Prevents directory traversal attacks
Input Validation: Validates folder paths and filenames
Scope Limiting: All operations are confined to the generated-resumes directory
Character Filtering: Removes or replaces invalid filesystem characters

Contributing

Fork the repository
Create a feature branch: git checkout -b feature-name
Make your changes and test thoroughly
Submit a pull request with a clear description

Credits

This project is built on top of several amazing open-source projects and services:

LaTeX Resume API

Service: latexresu.me - Professional LaTeX resume generation API
Credits: Thanks to the LaTeX Resume API team for providing the backend service that powers the PDF generation

LaTeX Templates

The beautiful resume templates are based on designs from resumake.io and the broader LaTeX community:

Rensselaer Career Development Center
Byungjin Park - Awesome CV template
Scott Clark - Clean and professional designs
Debarghya Das - Modern resume templates
Xavier Danaux - Classic LaTeX resume styles
Ratul Saha - Contemporary designs
Daniil Belyakov - Minimalist templates
Frits Wenneker - Professional CV templates

Technology Stack

MCP (Model Context Protocol) - Anthropic for the protocol specification
Claude Desktop - Integration platform for AI-powered tools
Node.js - Runtime environment for folder management and file operations
LaTeX - Document preparation system for high-quality typesetting

License

Support

🐛 Bug Reports: GitHub Issues
💡 Feature Requests: GitHub Discussions
📧 Contact: andrea.cadonna@gmail.com

Changelog

v2.0.0 - Folder Management Update

✨ NEW: Custom folder organization within generated-resumes directory
✨ NEW: create_folder tool for creating organized directory structures
✨ NEW: list_folders tool for browsing and managing resume collections
✨ NEW: Enhanced generate_resume with folderPath parameter
🛡️ NEW: Path sanitization and security features
📊 NEW: File metadata display (size, date) in directory listings
🗂️ NEW: Auto-creation of folder paths when generating resumes
📁 NEW: Support for nested folder structures
🔍 NEW: Directory navigation and file organization tools

v1.0.0

Initial release
Support for 9 LaTeX templates via LaTeX Resume API
Natural language resume generation through Claude Desktop
MCP server implementation with structured data support
Professional PDF output with customizable templates

Made with ❤️ for the Claude Desktop and MCP community