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

1. Clone the repository:

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

2. Install dependencies:

   npm install
   

3. 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"]
       }
     }
   }
   

4. 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

1. Share Your Experience - Provide Claude with your complete professional background, education, skills, and achievements
2. Specify Your Target - Optionally include a job description or mention the type of role you're targeting
3. Organize Your Resumes - Choose where to save each resume with custom folder structures
4. 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

1. "Method not found" errors:

   • Ensure Claude Desktop is restarted after configuration
   • Check that the path in claude_desktop_config.json is correct

2. Connection errors:

   • Verify internet connection
   • Check if the LaTeX Resume API is accessible

3. PDF not generated:

   • Check the generated-resumes directory permissions
   • Ensure the directory exists and is writable

4. Folder creation errors:

   • Verify write permissions in the generated-resumes directory
   • Check that folder paths don't contain invalid characters

5. 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

1. Fork the repository
2. Create a feature branch: git checkout -b feature-name
3. Make your changes and test thoroughly
4. 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