mcpField
C
contact-cache

contact-cache

github.com/gooseworks-aiMarketing & growth1.3k58 installsUpdated 3d ago
Repository

About contact-cache

Contact Cache is a CSV-backed contact tracking skill for teams running recurring outreach strategies. It deduplicates records by LinkedIn URL or email to help prevent contacting the same person more than once.

Key features

  1. 01Checks existing contacts
  2. 02Adds individual contacts
  3. 03Imports contacts from CSV
  4. 04Deduplicates by LinkedIn URL or email
  5. 05Tracks contact statuses

Use cases

  1. 01Checking a prospect list before outreach
  2. 02Recording a newly identified contact
  3. 03Importing an existing contact list
  4. 04Tracking contacts through outreach stages

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/gooseworks-ai/goose-skills --skill contact-cache

After installing, type/contact-cachein Claude Code to confirm it loaded.

Bundled filesscripts/cache.pyskill.meta.json

Details

From the project README

Contact Cache

Track all identified/contacted people across strategies. CSV-backed contact database with dedup by LinkedIn URL or email. Prevents duplicate outreach when running strategies on a recurring cadence.

Usage

# Check if contacts are already cached
python3 skills/contact-cache/scripts/cache.py check --linkedin-urls "https://linkedin.com/in/person1,https://linkedin.com/in/person2"
python3 skills/contact-cache/scripts/cache.py check --emails "[email protected],[email protected]"

# Add a single contact
python3 skills/contact-cache/scripts/cache.py add --name "John Smith" --linkedin-url "https://linkedin.com/in/johnsmith" --email "[email protected]" --company "Acme Corp" --title "VP Finance" --strategy "2A-hiring-signal"

# Bulk import from CSV
python3 skills/contact-cache/scripts/cache.py add --csv /path/to/leads.csv --strategy "2A-hiring-signal"

# Update a contact's status
python3 skills/contact-cache/scripts/cache.py update --linkedin-url "https://linkedin.com/in/johnsmith" --status contacted --notes "Sent intro email 2026-02-24"

# Export the full cache
python3 skills/contact-cache/scripts/cache.py export --format csv
python3 skills/contact-cache/scripts/cache.py export --format json
python3 skills/contact-cache/scripts/cache.py export --status contacted
python3 skills/contact-cache/scripts/cache.py export --strategy "2A-hiring-signal"

# Print summary statistics
python3 skills/contact-cache/scripts/cache.py stats

Data

Contacts are stored in skills/contact-cache/data/contacts.csv. The file is auto-created on first use.

Dedup is by LinkedIn URL (preferred) or email. Both are normalized and hashed (SHA256, first 16 chars) to produce a stable contact_id.

Valid Statuses

new, qualified, contacted, replied, meeting_booked, converted, not_interested

Comments

Markdown supported