mcpField
C
contact-cache

contact-cache

github.com/nikiandrMarketing & growth1129 installsUpdated 31w ago
Repository

About contact-cache

Contact Cache is a CSV-backed contact tracking skill for recurring outreach strategies. It checks and deduplicates people by LinkedIn URL or email, and records contacts across outreach statuses.

Key features

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

Use cases

  1. 01Check whether a prospect was contacted before
  2. 02Avoid duplicate outreach across recurring campaigns
  3. 03Import a contact list from CSV
  4. 04Track contacts from new to converted

Install

Copy the command and run it in a terminal.

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

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

Bundled files

References and scripts installed along with SKILL.md.

skill.meta.json
data/
contacts.csv
scripts/
cache.py

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