Skip to main content
Glama
RoaM04

NextFlows Academy MCP Starter

by RoaM04

Job Application Tracker MCP

A local Model Context Protocol (MCP) server for managing job applications. The server allows an AI assistant to add, delete, search, update, and manage job application data stored in a local JSON file.

The project works offline and does not require paid APIs or authentication.

Requirements

Before running the project, make sure you have:

  • Node.js 20 or later

  • npm

  • Git

  • VS Code or another code editor

  • MCP Inspector for testing the server

Check your Node.js and npm versions:

node -v
npm -v

Related MCP server: Hello World MCP Server

Install

Clone the repository:

git clone https://github.com/RoaM04/Job-Application-Tracker-Project.git

Move into the project folder:

cd Job-Application-Tracker-Project

Install the dependencies:

npm install

Run

Start the MCP server with:

npm run dev

The server runs using the stdio transport and waits for MCP requests.

You should see:

Job Application Tracker MCP server running on stdio

Keep the terminal running while using MCP Inspector.

MCP Inspector

To test the server with MCP Inspector, run:

npm run inspect

Open the Inspector interface, connect to the server, and select Tools.

Choose one of the available tools and provide the required input.

The project stores its data in:

data/job-applications.json

The examples/ directory contains example JSON inputs that can be reused when testing tools.

Tools

Tool

Description

add_job_application

Adds a new job application to the local JSON data file.

delete_job_application

Deletes an existing job application after confirmation.

update_application_status

Updates the status of an existing job application.

search_job_applications

Searches job applications using the available search criteria.

add_job_application_note

Adds a note to an existing job application.

remove_job_application_note

Removes a note from an existing job application.

list_job_applications

Lists stored job applications.

get_application_statistics

Returns statistics about the stored job applications.

update_job_application_details

Updates details of an existing job application.

get_job_application_details

Retrieves full details of job applications by company, job title, or both.

search_applications_by_date_range

Searches applications within a specified date range.

All application data is stored locally in:

data/job-applications.json

No external API or authentication is required.

Example Prompts

These are examples of requests that can be used with an AI assistant connected to the MCP server:

Add a job application for Google for a Software Engineer position.
Delete my Google Software Engineer application.
Update the status of my Google Software Engineer application to Interview.
Show me my job applications.
Search for job applications at Google.
Add a note to my Google Software Engineer application.
Show me statistics about my job applications.

The exact input fields required by each tool can also be checked in MCP Inspector.

Troubleshooting

1. npm install fails

Make sure Node.js 20 or later is installed:

node -v

If Node.js is missing or the version is too old, install a supported version and run:

npm install

again.

2. MCP Inspector cannot connect to the server

Make sure you are running the command from the project root:

npm run inspect

Also make sure there are no TypeScript or dependency errors in the terminal.

If the server is already running separately with npm run dev, stop it before starting Inspector if both commands try to use the same server process.

3. A tool cannot find or update an application

Check that:

data/job-applications.json

exists and contains valid JSON data.

For tests, restore the fixture data before trying another operation. Also make sure the company name and job title match an existing application.

License

MIT License.

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
2dResponse time
Release cycle
Releases (12mo)
Commit activity
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • -
    license
    C
    quality
    Not graded
    maintenance
    A simple boilerplate MCP server that provides a basic greeting tool for demonstration purposes. Serves as a starting template for developers to quickly create and deploy custom MCP servers.
    1
    9
  • A
    license
    C
    quality
    D
    maintenance
    A simple MCP server that provides a basic greeting tool for saying hello with customizable names. Serves as a boilerplate template for developers to quickly create and deploy new MCP servers.
    1
    9
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    A simple MCP server that provides a basic greeting tool and serves as a starter template for AWS Lambda deployment. Demonstrates how to build and deploy MCP servers with both local development and cloud deployment capabilities.
    1
    18
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A minimal template MCP server demonstrating basic tools, resources, and prompts functionality. Includes example implementations like a hello tool, history resource, and greet prompt for learning MCP development.
    1
    ISC

View all related MCP servers

Related MCP Connectors

  • Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.

  • MCP server for generating rough-draft project plans from natural-language prompts.

  • Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/RoaM04/Job-Application-Tracker-Project'

If you have feedback or need assistance with the MCP directory API, please join our Discord server