contactgraph

Build a private contact graph from Gmail and Google Contacts via OAuth.

2|Updated May 21, 2026
One-click install
npx skills add https://github.com/ContactGraph/contactgraph --skill contactgraph
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: contactgraph
Source: https://github.com/ContactGraph/contactgraph/tree/main
Command: npx skills add https://github.com/ContactGraph/contactgraph --skill contactgraph

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ContactGraph helps you answer questions about who you know, their roles, and where they work by building and querying a private contact graph from your messaging and contact sources.

Core Features & Use Cases

  • Connect & sync your sources: OAuth-connect a user and import contacts from Gmail and Google Contacts so the graph becomes queryable.
  • Natural-language network search: Ask questions like “Who do I know at Stripe?” and get ranked matches with reasons.
  • Second-degree visibility (trust list): Surface second-degree matches via an opt-in trust list and permissioned disclosure for deeper details.

Quick Start

Tell your agent to read the skill, connect the user's Google account via the provided connect-source flow, sync the sources until the graph is at least partially imported, and then ask your first question (for example: “Who do I know at Stripe?”).

Frequently Asked Questions about contactgraph

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search my contact graph to find who I know at a specific company?

Searching your contact graph is done through natural-language queries. After connecting your Google sources via OAuth, you can ask questions like “Who do I know at Stripe?” and receive ranked matches with reasons and provenance-aware discovery.

What is a contact graph and how does it map my network relationships?

A contact graph is a private network map built from your Google messaging and contact sources. It structures people and organizations to enable instant natural-language search over roles, relationships, and second-degree connections.

Does contact graph search work with Gmail and Google Contacts?

Yes, contact graph search works with Gmail and Google Contacts. You must OAuth-connect these Google sources and sync them until the graph is at least partially imported to enable natural-language queries over your network.

How do I find second-degree connections in my network?

You find second-degree connections by enabling an opt-in trust list. This surfaces permissioned second-degree matches via disclosure, providing deeper details about people and organizations linked to your direct contacts.

Do I need HTTPS to query my contact graph via MCP tools?

Yes, you need HTTPS access to query your contact graph via MCP or REST skill endpoints. The connection uses Bearer token authentication for secure API calls and returns structured matches with applied plans.