Concept — background and overview.
What this guide covers
This is a user-friendly orientation to Affinity MCP — what it is, who it’s for, and how to decide between deployment options. For setup steps specific to your AI tool, follow the per-client guides at developer.affinity.co.What Affinity MCP does
Affinity MCP (Model Context Protocol) lets you query, update, and clean up your Affinity CRM from outside Affinity — from inside AI tools like Claude, ChatGPT, Copilot, Notion Custom Agents, or Gemini CLI. Once configured, you can ask things like:- “Find all companies I first emailed in Q1 2024.”
- “Summarize the notes on Acme Corp from this quarter.”
- “Set a reminder to follow up with Jane Smith in two weeks.”
Who Affinity MCP is for
- Investment professionals querying pipeline, relationships, and meeting history from their preferred AI assistant
- Operators and admins updating CRM fields and creating reminders without switching contexts
- Developers building agentic workflows on top of Affinity data
Plan requirements
- Affinity plan: Scale, Advanced, or Enterprise (required for API and MCP access)
- AI client plan: Varies by client (e.g., ChatGPT works on the Free plan and up; Notion requires Business or Enterprise). See the compatibility table below or each per-client guide.
- Admin setup: MCP is enabled by default for Claude, ChatGPT, and Notion; an Affinity admin can disable it per client under Settings → Affinity MCP. Turning a client off also disconnects everyone who already connected it through OAuth. The setting only affects OAuth connections; users can still connect a client manually with an API key. Some AI clients also require their own workspace admin to turn MCP on first (e.g., Notion Business/Enterprise, Claude Team/Enterprise). See per-client guide.
Choose your deployment
Hosted (recommended for most users)
Affinity runs and updates the MCP server for you. Setup is minutes.- Server URL:
https://mcp.affinity.co/mcp - Best for: Anyone who wants the simplest path
- Authentication: OAuth (where supported) or API key
Local (for advanced users)
You run the MCP server yourself via theaffinity-mcp Python package. Useful when you need to keep MCP traffic within your own infrastructure or want to extend the server.
- Installation:
uvx affinity-mcp(installed and run via uv) - Authentication: API key only (set
AFFINITY_API_KEY) - Best for: Teams with specific security or customization requirements
- See Local Setup at developer.affinity.co for the full guide.
Set up your AI tool
Follow the dev-docs guide for your AI client:
Each per-client page leads with a compatibility callout, plan + admin requirements, and the exact setup steps.
Client compatibility at a glance
Every client requires an Affinity Scale, Advanced, or Enterprise plan. Beyond that, support differs by surface — including a few that surprise people:Test your connection
Once configured, try one of these in your AI chat to confirm it’s working:- Find 3 companies I emailed in the last 30 days.
- Show me my upcoming meetings.
- Summarize recent activity on Acme Corp.
What’s available
Browse the full tool catalog at Available tools. MCP can read, write, delete, and merge records in your CRM. High-level capabilities:- Relationship intelligence: Find connections, surface relationship strength, identify warm-intro paths
- Pipeline: Search and summarize opportunities, pull list entries and fields, track stage progress
- Meetings & activity: Review interactions and upcoming meetings, read meeting transcripts, log calls and messages
- Notes: Create, retrieve, search, edit, and delete notes on people / companies / opportunities / meetings (you can edit or delete only notes you created)
- Create & update records: Create companies, people, opportunities, lists, and fields; update field values and records
- Delete & merge: Delete list entries, opportunities, companies, and people; merge duplicate people and companies. Deleting records, notes and fields, and every merge, shows what it will affect and waits for your confirmation. Deleting a reminder or a dropdown option happens straight away, and deleting a dropdown option removes it from every entry and can’t be undone. If you connected before September 24, 2026, restart your AI client or start a new session to load these tools.
- Data Update: Run the Data Update agent on a note or meeting and review its suggested field updates; nothing is written until you confirm
- Files: Upload and download files on any record, up to 100 MB each
- Skills: Prepackaged workflows — Meeting Prep, Ranked Intro Paths, Market Map, Data Migration, Event Setup, Ready-to-Raise Indicator, Portfolio Check-in, Founder References, LP Pipeline Brief, Passed Deal Review, Data Quality Audit, and Company Signals. See Affinity MCP Skills
- Reminders: Set, list, and manage follow-up reminders