Notion Job Tracker MCP Server

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.

Related MCP server: Switchboard Notion MCP

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):

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"]
    }
  }
}