# Notion Job Tracker

Mirrors the career-ops tracker to a Notion database and reads leads back.

- Repository: https://github.com/career-ops-hq/career-ops (79256 stars)
- Category: Business
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add career-ops-hq/career-ops --skill career-ops-plugin-notion -g -a claude-code -y`
Codex: `npx skills add career-ops-hq/career-ops --skill career-ops-plugin-notion -g -a codex -y`
Cursor: `npx skills add career-ops-hq/career-ops --skill career-ops-plugin-notion -g -a cursor -y`
Gemini CLI: `npx skills add career-ops-hq/career-ops --skill career-ops-plugin-notion -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add career-ops-hq/career-ops`

## Description

How to mirror the career-ops tracker to a Notion database and read records back as job leads.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# notion plugin

Mirrors your application tracker to a Notion database (export) and reads records
back into the pipeline (search). `data/applications.md` stays the source of
truth, Notion is an additive mirror.

## Commands

- `node plugins.mjs run notion export`, push each tracker row (company / role /
  status / score) to the "Applications" database under your Career Ops page.
  Add `--dry-run` to preview without writing.
- `node plugins.mjs run notion search "<query>"`, return Notion records that
  carry a job URL, matching the query, and append them to the pipeline.

## Setup

A "Career Ops" parent page in Notion containing an "Applications" database with
Company / Role / Status / Score / URL properties, shared with your internal
integration. Put `NOTION_ACCESS_TOKEN` + `NOTION_PARENT_PAGE_ID` in `.env`.

## Data it produces

`search` returns `Job[]` ({ title, url, company, location }) for records that
have a job URL; the engine writes them to the pipeline. `export` returns
{ pushed: N }, it never writes local files.