jobseek-mcp 0.7.0 → 0.8.1

package/README.md

@@ -114,6 +114,23 @@ Upload a PDF resume to JobSeek.
 ### `analyze_matches`
 Review your recent job matches from the Chrome extension.
 
+### `my_applications`
+Get a list of your job applications with their current status, match scores, and status history with dates.
+
+**Example:** "Show me my recent applications"
+
+### `update_application_status`
+Update the status of a job application. Perfect for tracking application progress from email updates (Gmail parsing).
+
+**Parameters:**
+- `company` (required) - Company name to find the application
+- `jobTitle` (optional) - Job title to match (useful if you applied to multiple roles at same company)
+- `status` (required) - One of: `received`, `interviewing`, `rejected`, `offer`, `accepted`, `declined`
+- `date` (optional) - Date of the status change (YYYY-MM-DD format, defaults to today)
+- `notes` (optional) - Additional context (e.g., "Interview with Sarah scheduled")
+
+**Example:** "Update my Acme Corp application to interviewing status - interview scheduled for January 15th with the hiring manager"
+
 ## Automated Job Search (with Claude for Chrome)
 
 The most powerful feature! Use the `/auto_job_search` prompt to have Claude:

package/dist/server.js

@@ -9,6 +9,7 @@ import { getResumeLinkTool, handleGetResumeLink } from "./tools/get-resume-link.
 import { myApplicationsTool, handleMyApplications } from "./tools/my-applications.js";
 import { getFormDataTool, handleGetFormData } from "./tools/get-form-data.js";
 import { evaluateJobTool, handleEvaluateJob } from "./tools/evaluate-job.js";
+import { updateApplicationStatusTool, handleUpdateApplicationStatus } from "./tools/update-application-status.js";
 import { allResources, handleReadResource } from "./resources.js";
 import { allPrompts, getPromptMessages } from "./prompts.js";
 export function createServer(apiKey) {
@@ -39,6 +40,7 @@ export function createServer(apiKey) {
                 myApplicationsTool,
                 getFormDataTool,
                 evaluateJobTool,
+                updateApplicationStatusTool,
             ],
         };
     });
@@ -64,6 +66,8 @@ export function createServer(apiKey) {
                 return handleGetFormData(args, JOBSEEK_API_URL, apiKey);
             case "evaluate_job":
                 return handleEvaluateJob(args, JOBSEEK_API_URL, apiKey);
+            case "update_application_status":
+                return handleUpdateApplicationStatus(args, JOBSEEK_API_URL, apiKey);
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }

package/dist/tools/my-applications.js

@@ -97,19 +97,33 @@ export async function handleMyApplications(args, apiUrl, apiKey) {
         };
         for (const app of applications) {
             const emoji = statusEmoji[app.status.toLowerCase()] || '📄';
-            const date = new Date(app.createdAt).toLocaleDateString('en-US', {
+            const createdDate = new Date(app.createdAt).toLocaleDateString('en-US', {
                 month: 'short',
                 day: 'numeric',
                 year: 'numeric'
             });
+            // Get most recent status date from history
+            const latestHistory = app.statusHistory && app.statusHistory.length > 0
+                ? app.statusHistory[app.statusHistory.length - 1]
+                : null;
+            const statusDate = latestHistory?.date
+                ? new Date(latestHistory.date).toLocaleDateString('en-US', {
+                    month: 'short',
+                    day: 'numeric',
+                    year: 'numeric'
+                })
+                : createdDate;
             output += `## ${emoji} ${app.job.title}\n`;
             output += `**${app.job.company}**`;
             if (app.job.location)
                 output += ` • ${app.job.location}`;
             output += '\n';
-            output += `- Status: **${app.status}**\n`;
+            output += `- Status: **${app.status}** (${statusDate})\n`;
+            if (latestHistory?.notes) {
+                output += `- Notes: ${latestHistory.notes}\n`;
+            }
             output += `- Match Score: ${app.job.matchScore}%\n`;
-            output += `- Applied: ${date}\n`;
+            output += `- Applied: ${createdDate}\n`;
             output += `- Has Cover Letter: ${app.coverLetter ? 'Yes' : 'No'}\n`;
             output += `- Has Custom Resume: ${app.customResume ? 'Yes' : 'No'}\n`;
             output += '\n';

package/dist/tools/update-application-status.d.ts

@@ -0,0 +1,37 @@
+export declare const updateApplicationStatusTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            company: {
+                type: string;
+                description: string;
+            };
+            jobTitle: {
+                type: string;
+                description: string;
+            };
+            status: {
+                type: string;
+                enum: readonly ["received", "interviewing", "rejected", "offer", "accepted", "declined"];
+                description: string;
+            };
+            date: {
+                type: string;
+                description: string;
+            };
+            notes: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleUpdateApplicationStatus(args: unknown, apiUrl: string, apiKey?: string): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;

package/dist/tools/update-application-status.js

@@ -0,0 +1,131 @@
+import { z } from "zod";
+// Valid status values
+const VALID_STATUSES = ['received', 'interviewing', 'rejected', 'offer', 'accepted', 'declined'];
+// Tool definition
+export const updateApplicationStatusTool = {
+    name: "update_application_status",
+    description: `Update the status of a job application. Use this after parsing Gmail for job application emails to track interview requests, rejections, offers, etc.
+
+Statuses:
+- received: Application was received/acknowledged
+- interviewing: Interview scheduled or in progress
+- rejected: Application was rejected
+- offer: Received a job offer
+- accepted: Accepted an offer
+- declined: Declined an offer
+
+The tool finds the application by company name (and optionally job title).`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            company: {
+                type: "string",
+                description: "The company name (required). Used to find the matching application."
+            },
+            jobTitle: {
+                type: "string",
+                description: "The job title (optional). Helps find the correct application if user applied to multiple positions at the same company."
+            },
+            status: {
+                type: "string",
+                enum: VALID_STATUSES,
+                description: "The new status: received, interviewing, rejected, offer, accepted, or declined"
+            },
+            date: {
+                type: "string",
+                description: "The date of the status change (YYYY-MM-DD format). Defaults to today if not provided."
+            },
+            notes: {
+                type: "string",
+                description: "Optional notes about this status update (e.g., 'Interview scheduled with John Smith', 'Received confirmation email')"
+            }
+        },
+        required: ["company", "status"]
+    }
+};
+// Input validation
+const UpdateApplicationStatusInput = z.object({
+    company: z.string(),
+    jobTitle: z.string().optional(),
+    status: z.enum(VALID_STATUSES),
+    date: z.string().optional(),
+    notes: z.string().optional(),
+});
+// Tool handler
+export async function handleUpdateApplicationStatus(args, apiUrl, apiKey) {
+    const input = UpdateApplicationStatusInput.parse(args);
+    if (!apiKey) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `**API Key Required**\n\nGet your API key at: ${apiUrl}/dashboard/api-keys`
+                }]
+        };
+    }
+    try {
+        const response = await fetch(`${apiUrl}/api/applications/update-status`, {
+            method: 'PATCH',
+            headers: {
+                "Authorization": `Bearer ${apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                company: input.company,
+                jobTitle: input.jobTitle,
+                status: input.status,
+                date: input.date,
+                notes: input.notes
+            })
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `**Invalid API Key**\n\nGenerate a new key at: ${apiUrl}/dashboard/api-keys`
+                        }]
+                };
+            }
+            if (response.status === 404) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `**Application Not Found**\n\nNo application found for company "${input.company}"${input.jobTitle ? ` with title "${input.jobTitle}"` : ''}.\n\nMake sure the application exists in JobSeek first.`
+                        }]
+                };
+            }
+            const error = await response.json().catch(() => ({}));
+            return {
+                content: [{
+                        type: "text",
+                        text: `**Error**\n\n${error.error || 'Failed to update application status'}`
+                    }]
+            };
+        }
+        const result = await response.json();
+        // Format status emoji
+        const statusEmoji = {
+            'received': '📬',
+            'interviewing': '🎯',
+            'rejected': '❌',
+            'offer': '🎉',
+            'accepted': '✅',
+            'declined': '🚫',
+        };
+        const emoji = statusEmoji[input.status] || '📋';
+        return {
+            content: [{
+                    type: "text",
+                    text: `${emoji} **Status Updated**\n\n**${result.job.title}** at **${result.job.company}**\n\nStatus: **${input.status}**${input.date ? `\nDate: ${input.date}` : ''}${input.notes ? `\nNotes: ${input.notes}` : ''}\n\n---\nView application: ${apiUrl}/dashboard/applications`
+                }]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `**Error**\n\nFailed to update application status: ${error.message}`
+                }]
+        };
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "jobseek-mcp",
-    "version": "0.7.0",
+    "version": "0.8.1",
     "description": "JobSeek MCP Server - AI-powered job search automation for Claude. Enables automated job searching with Claude for Chrome browser control.",
     "author": "Shawn Mitchell",
     "license": "MIT",