# folk MCP > Folk MCP connects your entire professional network into any AI agent. Stop juggling spreadsheets and siloed tabs just to track who you talked to last week. This MCP lets you manage contacts, coordinate complex group lists, and build a complete interaction history for every person—all through simple conversation with your AI client. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** contact-management, relationship-tracking, crm-automation, team-collaboration, data-sync ## Description Need to keep tabs on everyone in sales, recruiting, or partnerships? Folk helps you stop manually updating contact records and start focusing on the relationship itself. Your agent can pull up a full profile for any connection, showing everything from their custom metadata to every meeting, email, and call recorded. It’s about having total oversight of your contacts: listing them all, seeing which groups they belong to, and understanding the context before you talk to them. When you connect this MCP via Vinkius, your agent handles the heavy lifting—creating new records or updating details programmatically with natural conversation. You get a single source of truth for every person in your professional ecosystem. ## Tools ### create_contact Creates a brand new person record in your folk CRM. ### get_contact_details Retrieves all specific information, including custom fields, for one contact. ### list_contacts Lists your entire network of contacts, with an option to filter by group ID. ### list_groups Retrieves a list of all existing contact groups you manage in folk. ### list_interactions Pulls up a complete log of every meeting, call, or email related to a specified contact. ### list_contact_notes Lists all private notes and comments attached to any given contact profile. ## Prompt Examples **Prompt:** ``` List all active contacts in my folk account. ``` **Response:** ``` I've retrieved your contacts. You have access to 150 profiles including 'John Doe', 'Sarah Miller', and 'Mike Ross'. Which one would you like to see the details or interaction history for? ``` **Prompt:** ``` Show me the recent interactions for 'John Miller' (ID: 10293). ``` **Response:** ``` Fetching interactions... For John Miller, there are 3 recent events: an email sent yesterday, a Zoom meeting from last week, and a call log. Would you like the details of the latest email? ``` **Prompt:** ``` Add a new contact: 'Anna White' (anna@example.com). ``` **Response:** ``` Success! Anna White (anna@example.com) has been added to your folk CRM with ID cont_88231. She is currently in your main directory. Would you like me to assign her to a group? ``` ## Capabilities ### Build and update contact profiles Create brand new contacts or adjust existing profile data using simple commands. ### List all network contacts Retrieve a comprehensive list of every person in your CRM, with the ability to filter by specific groups. ### Manage contact groups View and organize your contacts into defined lists or working groups within folk. ### Track communication history Pull up a complete timeline of every interaction, including emails sent, calls taken, and meetings held for any contact. ### Query notes and insights Access all stored comments and notes associated with a specific person's profile to remember key details. ## Use Cases ### The sales rep needs to prepare for a meeting. A sales rep is about to meet with Jane Doe. Instead of digging through old emails and spreadsheets, they ask their agent to check `list_interactions` for Jane Doe. The agent immediately provides three key touchpoints: an email sent last week, a call logged two weeks ago, and the notes showing her primary pain point is pricing. ### The recruiter needs to onboard new talent. A technical recruiter has five promising candidates. They ask their agent to run `list_contacts` filtered by 'Engineering Leads' group. The agent provides the list, and the recruiter can then use `get_contact_details` on each profile to confirm current job titles and status. ### The founder needs investor status updates. A startup founder is preparing for a board meeting. They ask their agent to list all contacts who are 'Venture Partners.' The agent uses `list_contacts` to provide the group, and then uses `list_contact_notes` to pull up recent insights from each investor. ### The BD team needs to clean up old records. A business development analyst finds a contact record missing critical information. They ask their agent to create a new record using `create_contact`, ensuring the profile has all required custom fields and that it's correctly assigned to the 'Partnership' group via `list_groups`. ## Benefits - Know the full story on every lead. Instead of guessing what happened last month, you can use `list_interactions` to pull up a complete history—emails, calls, meetings—in seconds. - Keep your data clean and organized. You can use `create_contact` or update details programmatically with natural conversation, eliminating the need for manual form entries. - Group management becomes simple. Use `list_groups` to see what pools of contacts exist and then filter them instantly using `list_contacts` based on those groups. - Never lose a detail again. Need context from an old discussion? Query all associated notes using `list_contact_notes` before making your next move. - Maintain operational visibility across the board. You can check account configurations and verify details directly through the agent, keeping everything in one place. ## How It Works The bottom line is that you talk to your agent how you normally would; it does the rest with folk. 1. Subscribe to the folk MCP and paste your API Key into the Vinkius catalog. 2. Connect this MCP to your preferred AI client, like Claude or Cursor. 3. Ask your agent a question about your contacts—for example, 'Show me all candidates in the marketing group'—and it performs the action. ## Frequently Asked Questions **How do I find out all my contacts in the folk CRM?** You can list your entire network using `list_contacts`. You'll get a comprehensive view that you can even filter down by specific groups if needed. **Can folk MCP create new contacts?** Yes, you can use the `create_contact` tool to programmatically add brand-new people into your CRM. You just tell the agent who they are and what details they need. **What is the difference between list_interactions and list_contact_notes?** List interactions gives you a timeline of events like calls or emails; list_contact_notes pulls out private, human-added comments and insights about that person. **Does folk MCP work with my existing group structure?** Yes. You can use `list_groups` to see all the predefined groups in your account, and then reference those names when asking the agent to list or filter contacts. **Is this only for sales teams to use with folk MCP?** No. Because it manages general professional relationships, recruiters and BD teams use it just as heavily for tracking candidates and partners.