job-tracker-student-mcp 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.1
+
+- Added optional `deadline_after` and `deadline_before` to `list_applications` to list applications due in a date range. Both dates are included.
+- Added `delete_application` to remove a duplicate or mistaken application by id.
+- Added `list_applications` to list applications with optional status and company filters to see ids without exporting a full report.
+- Added an optional `query` to `list_applications` that searches role, notes and source text, for example referral or LinkedIn.
+- Added `update_application` to change the deadline, notes, role or company of an existing application.
+
 ## 0.1.0
 
 - First version of the job application tracker with add_application, update_status, list_upcoming and export_report.

package/README.md

@@ -16,7 +16,7 @@ npx -y job-tracker-student-mcp
 2. "Move application 1 to interview on 2026-11-20 at 14:30."
 3. "What deadlines and interviews do I have in the next two weeks?"
 
-A free, open source [MCP](https://modelcontextprotocol.io) server named `job-tracker-student-mcp` on npm. Track internships, jobs, interviews and deadlines, see what is coming up, and export your list as CSV or Markdown. Runs on your computer with Claude Desktop, Claude Code, Cursor, VS Code and Windsurf. No internet, no login, no API keys. Your applications are saved in one JSON file that you can open, back up or delete. Free forever.
+A free, open source [MCP](https://modelcontextprotocol.io) server named `job-tracker-student-mcp` on npm. Track internships, jobs, interviews and deadlines, see what is coming up, and export your list as CSV or Markdown. Runs on your computer with Claude Desktop, Claude Code, Cursor, VS Code and Windsurf. No internet, no login, no API keys. Your applications are saved in one JSON file that you can open, back up or delete.
 
 ## Install
 
@@ -141,15 +141,21 @@ More things you can ask:
 - "Export all my applications as a CSV."
 - "Show only my offers as a Markdown table."
 - "Which deadlines have already passed?"
+- "Delete application 3, it was a duplicate."
+- "Which applications mention a referral?"
+- "Which applications have a deadline in November 2026?"
 
 ## Tools
 
-There are four tools. `list_upcoming` and `export_report` are read only. `add_application` and `update_status` write to the local JSON file and nothing else.
+There are seven tools. `list_applications`, `list_upcoming` and `export_report` are read only. `add_application`, `update_application`, `update_status` and `delete_application` write to the local JSON file and nothing else.
 
 | Tool | What it does | Parameters | Example prompt |
 | --- | --- | --- | --- |
 | `add_application` | Add a job or internship with company, role, deadline and source. | `company`, `role`, `deadline`, `source`, `type`, `status`, `notes` | "Add a Software Intern role at Shopify with a deadline of 2026-11-15, found on LinkedIn." |
 | `update_status` | Move an application between applied, interview, offer and rejected. | `id`, `status`, `interview_date`, `note` | "Move application 1 to interview on 2026-11-20 at 14:30." |
+| `update_application` | Update the deadline, notes, role or company of an existing application. | `id`, `company`, `role`, `deadline`, `notes` | "Update application 1 to set the deadline to 2026-11-20 and add a note about the referral." |
+| `delete_application` | Remove a duplicate or mistaken application for good. | `id` | "Delete application 3, it was a duplicate." |
+| `list_applications` | List applications with optional status, company, text query and deadline range filters to see ids. The query searches role, notes and source. | `status`, `company`, `query`, `deadline_after`, `deadline_before` | "Which applications have a deadline in November 2026?" |
 | `list_upcoming` | Show upcoming deadlines and interviews sorted by date, with reminders. | `days`, `include_overdue`, `today` | "What deadlines and interviews do I have in the next two weeks?" |
 | `export_report` | Export applications as CSV or Markdown. | `format`, `status` | "Export all my applications as a CSV." |
 
@@ -173,7 +179,7 @@ Applications are saved in `~/.job-tracker-student-mcp/applications.json`. Set th
 
 ## Comparison
 
-This tracker is built for job applications. Some servers focus on course or learning management systems, and some are general task trackers. 
+This tracker is built for job applications. Some servers focus on course or learning management systems, and some are general task trackers.
 
 Compared with course focused servers, this one works offline with no login to a learning system and no keys. It is job specific, with statuses for applied, interview, offer and rejected, and it tracks deadlines and interview dates with reminders.
 
@@ -225,6 +231,26 @@ npm test
 
 The tests call every tool through a real MCP client and save to a temporary folder, so they need no account or network. They need the newer Node.js from the Node version section above, because of the test runner.
 
+## More free student MCP servers
+
+All free, open source and read only where they touch your accounts. Browse the full list at [brightspacemcp.com/more-mcps](https://brightspacemcp.com/more-mcps/).
+
+| Server | What it does |
+| --- | --- |
+| [Brightspace MCP](https://github.com/AnonymousOnyx22/brightspace-d2l-mcp) | D2L Brightspace for AI. Due dates with real submission status, grades, a target grade calculator and course files. |
+| [Canvas MCP](https://github.com/AnonymousOnyx22/canvas-lms-student-mcp) | Canvas LMS for AI, read only. Due dates, missing work, grades and announcements. |
+| [Moodle MCP](https://github.com/AnonymousOnyx22/moodle-student-mcp) | Moodle for AI, read only. Due dates, overdue work, grades and announcements. |
+| [Google Classroom MCP](https://github.com/AnonymousOnyx22/google-classroom-student-mcp) | Google Classroom for AI, read only. Todos, due dates, missing work and grades. |
+| [GPA Calculator MCP](https://github.com/AnonymousOnyx22/gpa-calculator-mcp) | GPA, grade conversion and the grade you need on the final, for AI. Works offline, no account. |
+| [Citations MCP](https://github.com/AnonymousOnyx22/student-citations-mcp) | APA, MLA and Chicago citations from a DOI, an ISBN or typed details. No account. |
+| [Study Planner MCP](https://github.com/AnonymousOnyx22/study-planner-mcp) | Exam study schedules, spaced repetition dates, pomodoro plans and assignment milestones. Works offline. |
+| [Paper Finder MCP](https://github.com/AnonymousOnyx22/paper-finder-student-mcp) | Search scholarly papers, find open access copies and related work through OpenAlex. No key needed. |
+| [BibTeX Reference Manager MCP](https://github.com/AnonymousOnyx22/bibtex-reference-manager-mcp) | Clean, convert, dedupe and lint BibTeX, RIS and CSL JSON reference lists, and make cite keys. Works offline. |
+| [Open Textbook Finder MCP](https://github.com/AnonymousOnyx22/open-textbook-finder-mcp) | Find free legal copies of textbooks on OpenStax, DOAB and Open Library, look up editions by ISBN and suggest cheaper older ones. |
+| [STEM Calculator MCP](https://github.com/AnonymousOnyx22/stem-calc-student-mcp) | Chemistry and physics homework math: molar mass, balancing equations, grams to moles, unit conversion and significant figures. Works offline. |
+| [Essay Stats MCP](https://github.com/AnonymousOnyx22/essay-stats-mcp) | Offline writing metrics for essays. Word and page counts, readability scores, passive voice, repeated openers, filler words, long sentences and word limit checks, so students can check their work against assignment requirements. No account, no network. |
+| [Syllabus to Calendar MCP](https://github.com/AnonymousOnyx22/syllabus-calendar-mcp) | Syllabus to calendar MCP server. Extract dates from syllabus text, build an ics calendar, expand recurring classes and merge calendars. Works offline, no account. |
+
 ## License
 
 MIT

package/build/src/server.js

@@ -2,7 +2,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { registerTools } from "./core/tools.js";
 import { tools } from "./tools.js";
 import { Store } from "./tracker.js";
-export const VERSION = "0.1.0";
+export const VERSION = "0.1.1";
 export function createServer(store = new Store()) {
     const server = new McpServer({ name: "job-tracker-student-mcp", version: VERSION });
     registerTools(server, tools, store);

package/build/src/tools.js

@@ -71,7 +71,7 @@ export const tools = [
         title: "Update status",
         readOnly: false,
         description: "Move an application to another stage: applied, interview, offer or rejected. " +
-            "Inputs: id of the application (from add_application or export_report), the new status, an optional interview_date as YYYY-MM-DD or YYYY-MM-DDTHH:MM, and an optional note that is added to the notes. " +
+            "Inputs: id of the application (from add_application or list_applications), the new status, an optional interview_date as YYYY-MM-DD or YYYY-MM-DDTHH:MM, and an optional note that is added to the notes. " +
             "When the status is interview, pass interview_date so list_upcoming can remind you. " +
             'Example prompt: "Move application 1 to interview on 2026-11-20 at 14:30."',
         inputSchema: {
@@ -88,7 +88,7 @@ export const tools = [
             const apps = store.list();
             const app = apps.find((a) => a.id === args.id);
             if (!app)
-                throw new Error(`There is no application with id ${args.id}. Use export_report to see the ids.`);
+                throw new Error(`There is no application with id ${args.id}. Use list_applications to see the ids.`);
             const when = args.interview_date ? checkWhen(args.interview_date.trim()) : null;
             const previous = app.status;
             app.status = args.status;
@@ -104,6 +104,109 @@ export const tools = [
             return { text: `${brief(app)} ${moved}${at}.`, structured: { previous_status: previous, application: app } };
         },
     },
+    {
+        name: "update_application",
+        title: "Update application",
+        readOnly: false,
+        description: "Update the deadline, notes, role or company of an existing application. " +
+            "Inputs: id of the application (from add_application or list_applications), and any of company, role, deadline as YYYY-MM-DD and notes. Only the fields you pass are changed; the rest stay the same. " +
+            "Pass an empty deadline to clear it. " +
+            'Example prompt: "Update application 1 to set the deadline to 2026-11-20 and add a note about the referral."',
+        inputSchema: {
+            id: z.number().int().positive().describe("The id of the application."),
+            company: z.string().min(1).optional().describe("New company name."),
+            role: z.string().min(1).optional().describe("New role title."),
+            deadline: z.string().optional().describe("New deadline as YYYY-MM-DD, or an empty string to clear it."),
+            notes: z.string().optional().describe("New notes, replacing the old ones."),
+        },
+        outputSchema: { application: appFields.describe("The application after the change.") },
+        run: async (args, store) => {
+            const apps = store.list();
+            const app = apps.find((a) => a.id === args.id);
+            if (!app)
+                throw new Error(`There is no application with id ${args.id}. Use list_applications to see the ids.`);
+            if (args.company !== undefined)
+                app.company = args.company.trim();
+            if (args.role !== undefined)
+                app.role = args.role.trim();
+            if (args.deadline !== undefined) {
+                const d = args.deadline.trim();
+                app.deadline = d ? checkDeadline(d) : null;
+            }
+            if (args.notes !== undefined)
+                app.notes = clean(args.notes);
+            app.updated = todayOr();
+            store.save(apps);
+            return { text: `Updated ${brief(app)}.`, structured: { application: app } };
+        },
+    },
+    {
+        name: "delete_application",
+        title: "Delete application",
+        readOnly: false,
+        description: "Remove an application from the tracker, for example a duplicate or a mistaken entry. " +
+            "Inputs: id of the application (from add_application or list_applications). The application is deleted from the local file and cannot be brought back, and the ids of the other applications do not change. " +
+            'Example prompt: "Delete application 3, it was a duplicate."',
+        inputSchema: {
+            id: z.number().int().positive().describe("The id of the application to delete."),
+        },
+        outputSchema: { deleted: appFields.describe("The application that was removed.") },
+        run: async (args, store) => {
+            const apps = store.list();
+            const app = apps.find((a) => a.id === args.id);
+            if (!app)
+                throw new Error(`There is no application with id ${args.id}. Use list_applications to see the ids.`);
+            store.save(apps.filter((a) => a.id !== args.id));
+            return { text: `Deleted ${brief(app)}.`, structured: { deleted: app } };
+        },
+    },
+    {
+        name: "list_applications",
+        title: "List applications",
+        readOnly: true,
+        description: "List applications with optional status and company filters, an optional text query and an optional deadline range. " +
+            "Inputs: optional status to filter by stage, an optional company substring to match (case insensitive), an optional query that searches the role, notes and source text (case insensitive), for example referral or LinkedIn, and optional deadline_after and deadline_before as YYYY-MM-DD. Both dates are included, and applications without a deadline are left out when you pass either one. " +
+            "Returns all matching applications as a structured list with their ids, so you can see application ids without exporting a full report. " +
+            'Example prompt: "Which applications have a deadline in November 2026?"',
+        inputSchema: {
+            status: z.enum(STATUSES).optional().describe("Only list applications in this stage."),
+            company: z.string().optional().describe("Only list applications whose company name contains this text (case insensitive)."),
+            query: z.string().optional().describe("Only list applications whose role, notes or source contains this text (case insensitive)."),
+            deadline_after: z.string().optional().describe("Only list applications with a deadline on or after this YYYY-MM-DD date."),
+            deadline_before: z.string().optional().describe("Only list applications with a deadline on or before this YYYY-MM-DD date."),
+        },
+        outputSchema: {
+            count: z.number().describe("How many applications match."),
+            applications: z.array(appFields).describe("The matching applications."),
+        },
+        run: async (args, store) => {
+            const after = args.deadline_after?.trim() ? checkDeadline(args.deadline_after.trim()) : null;
+            const before = args.deadline_before?.trim() ? checkDeadline(args.deadline_before.trim()) : null;
+            const all = store.list();
+            let apps = all;
+            if (args.status)
+                apps = apps.filter((a) => a.status === args.status);
+            if (args.company && args.company.trim()) {
+                const needle = args.company.trim().toLowerCase();
+                apps = apps.filter((a) => a.company.toLowerCase().includes(needle));
+            }
+            const query = args.query ? args.query.trim().toLowerCase() : "";
+            if (query) {
+                apps = apps.filter((a) => [a.role, a.notes, a.source].some((f) => (f ?? "").toLowerCase().includes(query)));
+            }
+            if (after)
+                apps = apps.filter((a) => a.deadline !== null && a.deadline >= after);
+            if (before)
+                apps = apps.filter((a) => a.deadline !== null && a.deadline <= before);
+            apps = [...apps].sort((a, b) => a.id - b.id);
+            const label = args.status ? ` in the ${args.status} stage` : "";
+            const comp = (args.company && args.company.trim() ? ` for company matching "${args.company.trim()}"` : "") + (query ? ` with "${args.query.trim()}" in the role, notes or source` : "") + (after ? ` with a deadline on or after ${after}` : "") + (before ? ` with a deadline on or before ${before}` : "");
+            return {
+                text: `Found ${apps.length} ${apps.length === 1 ? "application" : "applications"}${label}${comp}.\n\n${apps.map((a) => `#${a.id} ${a.role} at ${a.company} [${a.status}]`).join("\n") || "None."}`,
+                structured: { count: apps.length, applications: apps },
+            };
+        },
+    },
     {
         name: "list_upcoming",
         title: "List upcoming",

package/build/src/tracker.js

@@ -62,7 +62,7 @@ export function checkWhen(text) {
 export function todayOr(text) {
     if (text !== undefined) {
         if (!isDate(text))
-            throw new Error(`The date "${text}" is not a real date. Use YYYY-MM-DD.`);
+            throw new Error(`The date "${text}" is not a real date. Use YYYY-MM-DD, for example 2026-11-15.`);
         return text;
     }
     const now = new Date();

package/llms.txt

@@ -1,12 +1,12 @@
 # job-tracker-student-mcp
 
-> Job application tracker MCP server. Track internships, jobs, interviews and deadlines offline with reminders and status updates. Works offline, no account. Free and open source, works with Claude Desktop, Claude Code, Cursor, VS Code and Windsurf.
+> Job application tracker MCP server. Track internships, jobs, interviews and deadlines offline, with status updates and a list of what is coming up. No account. Free and open source, works with Claude Desktop, Claude Code, Cursor, VS Code and Windsurf.
 
 ## Setup
 - Run with npx -y job-tracker-student-mcp
 - Works offline, no account. No API keys, no passwords and no network calls.
 - Applications are saved in one JSON file at ~/.job-tracker-student-mcp/applications.json. Set the JOB_TRACKER_FILE environment variable to use another path.
-- add_application and update_status write to that file. list_upcoming and export_report only read it.
+- add_application, update_status, update_application and delete_application write to that file. list_applications, list_upcoming and export_report only read it.
 
 ## Stages and dates
 - An application is in one of four stages: applied, interview, offer or rejected.
@@ -30,7 +30,7 @@ Output: One sentence naming the new application, its id, type, status and deadli
 Structured output: application with id, company, role, type, status, deadline, interview_date, source, notes, added and updated.
 
 ### update_status
-Move an application to another stage: applied, interview, offer or rejected. Inputs: id of the application (from add_application or export_report), the new status, an optional interview_date as YYYY-MM-DD or YYYY-MM-DDTHH:MM, and an optional note that is added to the notes. When the status is interview, pass interview_date so list_upcoming can remind you. Example prompt: "Move application 1 to interview on 2026-11-20 at 14:30."
+Move an application to another stage: applied, interview, offer or rejected. Inputs: id of the application (from add_application or list_applications), the new status, an optional interview_date as YYYY-MM-DD or YYYY-MM-DDTHH:MM, and an optional note that is added to the notes. When the status is interview, pass interview_date so list_upcoming can remind you. Example prompt: "Move application 1 to interview on 2026-11-20 at 14:30."
 Parameters: id, status, interview_date, note.
 - id: The id of the application. Required.
 - status: The stage: "applied", "interview", "offer" or "rejected". Required.
@@ -40,6 +40,38 @@ Example call: `{"name":"update_status","arguments":{"id":1,"status":"interview",
 Output: One sentence saying the application moved from one stage to another, with the interview date when there is one.
 Structured output: previous_status, and application with id, company, role, type, status, deadline, interview_date, source, notes, added and updated.
 
+### update_application
+Update the deadline, notes, role or company of an existing application. Inputs: id of the application (from add_application or list_applications), and any of company, role, deadline as YYYY-MM-DD and notes. Only the fields you pass are changed; the rest stay the same. Pass an empty deadline to clear it. Example prompt: "Update application 1 to set the deadline to 2026-11-20 and add a note about the referral."
+Parameters: id, company, role, deadline, notes.
+- id: The id of the application. Required.
+- company: New company name.
+- role: New role title.
+- deadline: New deadline as YYYY-MM-DD, or an empty string to clear it.
+- notes: New notes, replacing the old ones.
+Example call: `{"name":"update_application","arguments":{"id":1,"deadline":"2026-11-20","notes":"Referred by a friend"}}`
+Output: One sentence naming the updated application.
+Structured output: application with id, company, role, type, status, deadline, interview_date, source, notes, added and updated.
+
+### delete_application
+Remove an application from the tracker, for example a duplicate or a mistaken entry. Inputs: id of the application (from add_application or list_applications). The application is deleted from the local file and cannot be brought back, and the ids of the other applications do not change. Example prompt: "Delete application 3, it was a duplicate."
+Parameters: id.
+- id: The id of the application to delete. Required.
+Example call: `{"name":"delete_application","arguments":{"id":3}}`
+Output: One sentence naming the deleted application.
+Structured output: deleted with id, company, role, type, status, deadline, interview_date, source, notes, added and updated.
+
+### list_applications
+List applications with optional status and company filters, an optional text query and an optional deadline range. Inputs: optional status to filter by stage, an optional company substring to match (case insensitive), an optional query that searches the role, notes and source text (case insensitive), for example referral or LinkedIn, and optional deadline_after and deadline_before as YYYY-MM-DD. Both dates are included, and applications without a deadline are left out when you pass either one. Returns all matching applications as a structured list with their ids, so you can see application ids without exporting a full report. Example prompt: "Which applications have a deadline in November 2026?"
+Parameters: status, company, query, deadline_after, deadline_before.
+- status: Only list applications in this stage.
+- company: Only list applications whose company name contains this text (case insensitive).
+- query: Only list applications whose role, notes or source contains this text (case insensitive).
+- deadline_after: Only list applications with a deadline on or after this YYYY-MM-DD date.
+- deadline_before: Only list applications with a deadline on or before this YYYY-MM-DD date.
+Example call: `{"name":"list_applications","arguments":{}}`
+Output: A sentence with the number of applications found, then a short list of id, role and company with status.
+Structured output: count and applications with id, company, role, type, status, deadline, interview_date, source, notes, added and updated.
+
 ### list_upcoming
 Show upcoming deadlines and interviews sorted by date, with a reminder for each one. Deadlines come from applications still in the applied stage, and interviews come from applications in the interview stage that have an interview_date. Rejected applications and offers are left out. Inputs: optional days, how far ahead to look (default 14), include_overdue (default true) to also show deadlines that already passed, and an optional today as YYYY-MM-DD to ask as if it were another day. Example prompt: "What deadlines and interviews do I have in the next two weeks?"
 Parameters: days, include_overdue, today.
@@ -59,6 +91,13 @@ Example call: `{"name":"export_report","arguments":{"format":"csv"}}`
 Output: A sentence with the number of applications exported, then the report.
 Structured output: format, count and content.
 
+## More things you can ask
+- "Export all my applications as a CSV."
+- "Which deadlines have already passed?"
+- "Delete application 3, it was a duplicate."
+- "Which applications mention a referral?"
+- "Which applications have a deadline in November 2026?"
+
 ## FAQ
 
 ### Does it send reminders on its own?

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "job-tracker-student-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Job application tracker MCP server that works offline. Track internships, jobs, interviews and deadlines, see what is coming up, and export to CSV or Markdown. No account and no API keys.",
   "type": "module",
   "main": "build/src/index.js",
@@ -42,7 +42,6 @@
     "job search",
     "job hunt",
     "interview tracker",
-    "interview scheduler",
     "deadline reminders",
     "application deadlines",
     "application status",