🧠 MCP Job Application Tracker & Resume Customizer

An MCP (Model Context Protocol) server that automates your job application process using AI. It connects with Google Drive, Notion, and Gmail to help you track applications, generate tailored resumes and cover letters, and send follow-up reminders.

✨ Features

• AI-Powered Resume & Cover Letter Generation: Uses Claude to create tailored documents for each job
• Google Drive Integration: Automatically saves generated documents to your Drive
• Notion Database Tracking: Logs all job applications with status tracking
• Follow-up Email Automation: Sends reminder emails for applications that need attention
• MCP Protocol: Works seamlessly with MCP-compatible AI assistants

🚀 Quick Start

1. Install Dependencies

npm install

2. Set Up Environment Variables

Copy the example environment file and fill in your API keys:

cp env.example .env

For Windows users: You can also use the provided setup-env.bat or setup-env-windows.bat scripts. ⚠️ IMPORTANT: Edit these files first to replace placeholder values with your actual API keys before running them. Never commit files containing real API keys!

You'll need to set up:

• Anthropic API Key: Get from Anthropic Console
• Google OAuth Credentials: Set up a project in Google Cloud Console
• Notion Integration: Create an integration in Notion Developers

3. Build the Project

npm run build

4. Run the MCP Server

npm start

🔧 Setup Instructions

Google APIs Setup

1. Go to Google Cloud Console
2. Create a new project or select existing one
3. Enable the following APIs:
   • Google Drive API
   • Gmail API
4. Create OAuth 2.0 credentials:
   • Application type: Web application
   • Authorized redirect URIs: http://localhost:3000/auth/google/callback
5. Copy the Client ID and Client Secret to your .env file

Notion Setup

1. Go to Notion Developers
2. Create a new integration
3. Copy the Internal Integration Token to your .env file
4. Create a database in Notion with the following properties:
   • Job Title (Title)
   • Company (Text)
   • Status (Select: drafted, applied, interviewing, offer, rejected, withdrawn)
   • Applied Date (Date)
   • Follow-up Date (Date)
   • Resume URL (URL)
   • Cover Letter URL (URL)
   • Notes (Text)
   • Created (Date)
   • Last Updated (Date)
5. Share the database with your integration
6. Copy the database ID to your .env file

📖 Usage

Available Tools

The MCP server provides the following tools:

process_job_application

Process a new job application by generating tailored resume and cover letter.

Parameters:

• jobTitle (string): The title of the job position
• companyName (string): The name of the company
• jobDescription (string): The full job description text
• resumeData (object): Your resume information

Example:

{
  "jobTitle": "Senior Software Engineer",
  "companyName": "Tech Corp",
  "jobDescription": "We are looking for a senior software engineer...",
  "resumeData": {
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+1-555-0123",
    "location": "San Francisco, CA",
    "summary": "Experienced software engineer...",
    "experience": [...],
    "education": [...],
    "skills": ["JavaScript", "Python", "React"],
    "projects": [...]
  }
}

get_job_applications

Retrieve all job applications from your Notion database.

update_job_status

Update the status of a job application.

Parameters:

• pageId (string): The Notion page ID
• status (string): New status (drafted, applied, interviewing, offer, rejected, withdrawn)
• notes (string, optional): Additional notes

send_follow_up_emails

Send follow-up emails for applications that need attention.

Parameters:

• recipientEmail (string): Email address to send follow-ups to

get_google_auth_url

Get the Google OAuth URL for setting up access.

🔄 Workflow

1. Find a Job: When you find a job you want to apply for
2. Process Application: Use process_job_application with the job details and your resume data
3. Review Documents: Check the generated resume and cover letter in Google Drive
4. Submit Application: When you submit, update the status to "applied"
5. Track Progress: Monitor your applications in Notion
6. Follow Up: Use send_follow_up_emails to send reminders

🛠️ Development

Project Structure

src/
├── config/          # Configuration management
├── services/        # External service integrations
│   ├── openai.ts    # OpenAI GPT integration
│   ├── google.ts    # Google Drive & Gmail
│   └── notion.ts    # Notion database
├── types/           # TypeScript type definitions
└── index.ts         # Main MCP server

Available Scripts

• npm run dev: Run in development mode with hot reload
• npm run build: Build the TypeScript project
• npm start: Run the built server
• npm run watch: Watch for changes and rebuild

🔒 Security

• All API keys are stored in environment variables
• Google OAuth uses secure token exchange
• No sensitive data is logged or stored in plain text

⚠️ Important Security Practices

NEVER commit API keys to version control!

• Always use .env files for your API keys (already in .gitignore)
• If using setup-env.bat or setup-env-windows.bat scripts, replace placeholders with your actual keys locally
• Keep your API keys private and rotate them immediately if exposed
• For Windows users: Copy the setup script templates, add your keys, but do NOT commit them back to the repository

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

📄 License

MIT License - see LICENSE file for details

🆘 Support

If you encounter any issues:

1. Check that all environment variables are set correctly
2. Verify your API keys have the necessary permissions
3. Ensure your Notion database has the correct structure
4. Check the console for error messages

For more help, please open an issue on GitHub.