Notion Job Tracker

What it does

An MCP (Model Context Protocol) server that connects to a Notion job tracker database and exposes it as a set of tools Claude (or any MCP client) can call directly — searching, adding, and updating job leads without leaving the conversation.

Tools

• search_jobs(keyword: str) — Searches the database for job leads whose job title or company name contains keyword.
• add_job(role: str, company: str, status: str, apply_link: str, location: str = "", salary_range: str = "") — Adds a new job lead row.
• update_status(page_id: str, status: str) — Updates the status of an existing job lead by its Notion page id.

Notion database schema

This server expects the database to have these properties (rename in server.py if yours differ):

Property	Type
Role	Title
Company	Text
Status	Select
Apply Link	URL
Location	Text
Salary Range	Text

Setup

1. Install dependencies:

   pip install -r requirements.txt
   

2. Create a Notion integration at https://www.notion.so/my-integrations, copy its secret, and share your job tracker database with that integration.

3. Copy .env.example to .env and fill in your values:

   cp .env.example .env
   

   NOTION_TOKEN=secret_xxx
   NOTION_DATABASE_ID=your-database-id
   

   The database id is the 32-character string in your database's URL.

4. Run the server:

   python server.py
   

Using with an MCP client

Add an entry to your MCP client's config, e.g. for Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "notion-job-tracker": {
      "command": "python",
      "args": ["/absolute/path/to/server.py"]
    }
  }
}