crmapi_key

Folk

folk is a next-generation CRM designed for teams to manage and nurture their relationships efficiently.

Verdict

Folk is a lightweight CRM that teams use to track contacts, companies, and deal pipelines. In Switchy, @mentioning Folk lets you query your contact database, create or update records, and pull relationship context into conversations without opening another tab. Sales reps use it to prep for calls, support teams use it to look up account history, and founders use it to keep tabs on investor outreach. The MCP exposes 12 tools covering people, companies, and custom fields. You'll need an API key from Folk's settings, and all operations run under that key's permissions — no granular scoping, so treat it like admin access.

Common use cases

  • Prep for sales calls with contact history
  • Log new leads from Slack or email threads
  • Check deal status during standup
  • Enrich support tickets with account context
  • Track investor outreach in one view

Integration

Vendor
Folk
Category
crm
Auth
API_KEY
Tools
12
Composio slug
folk

Tools

  • Create Company

    Tool to create a new company in the workspace. use after gathering all required company details and ensuring the name is unique.

  • Delete Company
    destructive

    Tool to delete a company from the workspace (irreversible). use after confirming this company should be removed.

  • Delete Person
    destructive

    Tool to delete an existing person in the workspace (irreversible). use after confirming this person should be permanently removed.

  • Get Company

    Tool to retrieve an existing company by its id. use after authentication has been verified.

  • Get Current Workspace User

    Tool to get details of the current authenticated workspace user. use after authentication to retrieve the user's profile information.

  • Get Person

    Tool to retrieve an existing person by their id. use when you need full profile details of a person by their unique identifier.

  • List Companies

    Tool to list companies in the workspace. use when you need a paginated overview of companies, optionally filtered.

  • List Group Custom Fields

    Tool to list custom fields for a specific group and entity type. use after selecting a group and entity type to inspect available custom fields.

  • List Groups

    Tool to list workspace groups. use when you need to retrieve a paginated list of all workspace groups after authentication.

  • List People

    Tool to list people in the workspace. use when you need to paginate through contacts after authentication.

  • List Users

    Tool to list workspace users. use when you need to paginate through users list.

  • Update Company

    Tool to update an existing company in the workspace. use after confirming the company id; only provided fields are updated and list fields replace existing values.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to the Integrations page. 2. Find Folk in the MCP directory and click Connect. 3. Log into your Folk account in a separate tab, go to Settings → API, and generate a new API key. 4. Copy the key and paste it into the Switchy connection dialog, then click Authorize. 5. Switchy will test the connection by fetching your workspace user profile — if it succeeds, you'll see a green checkmark. 6. Open any Space, type '@Folk list companies' in the chat, and send the message. 7. Folk should return a paginated list of companies from your workspace, confirming the integration is live. 8. From now on, @mention Folk in any Space to invoke its tools — create contacts, retrieve profiles, or search your CRM without leaving the conversation.

What teammates see: by default, memories from Folk are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Find Recent Contacts

@Folk list all people added to the workspace in the past month, sorted by creation date descending.
Open in a Space →

Create Lead from Notes

@Folk create a new person named Alex Chen, email alex@startup.io, company Startup Inc, and tag as 'inbound lead'.
Open in a Space →

Lookup Company Profile

@Folk get the company record for Acme Corp and show me all custom fields and recent activity.
Open in a Space →

Audit Custom Fields

@Folk list all custom fields for the 'Sales Pipeline' group and entity type 'Company'.
Open in a Space →

Check My Workspace Role

@Folk get the current workspace user details and show me my role and permissions.
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@Folk show me all companies in our pipeline that haven't been contacted in the last 30 days

Output

Based on Folk's company records, here are 8 companies matching your criteria: Acme Corp (last contact: 42 days ago, stage: Qualified), BuildRight Inc (last contact: 35 days ago, stage: Discovery), TechFlow Systems (last contact: 31 days ago, stage: Proposal)... Each entry includes the company name, days since last contact, current pipeline stage, and assigned owner. This list helps you identify follow-up priorities in your sales workflow.

Notes

This example uses List Companies with filtering logic. The MCP returns raw company data; the AI layers on the time-based filtering and formatting. Requires read access to your Folk workspace. If your workspace uses custom pipeline stages, those will appear instead of the standard stage names shown here.

Prompt

@Folk create a new person record for Sarah Chen at Vertex Labs, title VP of Engineering, email sarah.chen@vertexlabs.com

Output

I've created a new person record in Folk for Sarah Chen. The profile includes: Full Name: Sarah Chen, Company: Vertex Labs, Title: VP of Engineering, Email: sarah.chen@vertexlabs.com. The record has been assigned a unique ID and is now visible in your Folk workspace. You can add additional custom fields or notes directly in Folk, or ask me to update specific fields if you have more information.

Notes

This example demonstrates the Create Person tool (not shown in the representative list but analogous to Create Company). The MCP performs the write operation immediately—there's no undo via the API. If Vertex Labs doesn't exist as a company in your workspace, you may need to create that record first or the company field will remain unlinked.

Prompt

@Folk pull the full profile for company ID comp_abc123 and draft a personalized outreach email based on their industry and recent activity

Output

I retrieved the Folk profile for CloudScale Solutions (comp_abc123): Industry: Cloud Infrastructure, Stage: Qualified, Last Contact: 18 days ago via demo call, Notes indicate interest in enterprise security features. Here's a draft outreach: 'Hi [Contact Name], Following up on our demo discussion about enterprise security—I wanted to share how our SOC 2 compliance and role-based access controls have helped similar cloud infrastructure companies...' This draft incorporates the company's stated priorities from your Folk notes.

Notes

This example chains Get Company (data retrieval) with AI synthesis. The MCP provides structured company data; the AI uses that context to generate the email. The quality of the draft depends entirely on how much detail your team has logged in Folk's custom fields and notes—sparse records yield generic emails.

Use-case deep-dives

Outbound SDR list building

When Folk beats a spreadsheet for 2-person sales teams

A two-person startup doing cold outreach needs a single source of truth for 200-500 prospects without paying for full Salesforce seats. Folk's MCP wins here because the AI can create and update company and person records in real time during research calls—no alt-tabbing to a CRM UI. The List Companies and Get Person tools let the AI pull context mid-conversation ("what did we learn about this prospect last month?") without breaking flow. The threshold: if you're tracking more than three custom deal stages or need territory assignment, Folk's lightweight model starts to hurt. For early-stage outbound where speed matters more than pipeline rigor, this MCP keeps your CRM in sync without hiring a sales ops person.

Customer success check-in prep

Prepping account reviews when your CS team is one person

A solo customer success manager at a 30-customer B2B SaaS company uses Folk to track account health and renewal dates. Before a quarterly business review, the AI uses Get Company and List Group Custom Fields to surface the customer's onboarding notes, last NPS score, and feature requests—all stored as Folk custom fields. The MCP's Delete Person tool matters less here, but the ability to update company records after the call ("they mentioned a new stakeholder") keeps the system current without a post-meeting data-entry ritual. This breaks down if you need automated workflows or integration with a support ticketing system—Folk doesn't replace Gainsight. But for a lean CS motion where one person owns 20-40 accounts, it's faster than juggling Notion and a spreadsheet.

Investor pipeline tracking for solo GPs

Why this MCP works for small fund deal flow

A solo general partner running a $10M micro-fund uses Folk to track 50-100 startup conversations per quarter. The AI can create company records during intro calls, tag them with custom fields like "thesis fit" or "round size," and later pull up the full pipeline with List Companies when the GP is prioritizing follow-ups. The Get Current Workspace User tool confirms auth at session start, which matters when switching between personal and fund contexts. The limitation: Folk has no native email sync or calendar integration, so if your deal flow depends on parsing forwarded pitch decks or auto-logging meetings, you'll still need Airtable or Affinity. For GPs who prefer conversational deal logging over rigid pipeline stages, this MCP keeps the CRM lean and actually used.

Frequently asked

What does the Folk MCP let me do in Switchy?

The Folk MCP connects your Folk CRM workspace to Switchy so AI agents can read, create, update, and delete contacts and companies. Agents can list companies, retrieve person profiles, manage custom fields, and perform bulk operations without switching tabs. It's useful for automating CRM hygiene, enriching contact records, or pulling relationship data into reports.

Do I need admin access to connect Folk to Switchy?

You need a Folk API key, which typically requires workspace admin or owner permissions to generate. Folk doesn't use OAuth; you'll paste the API key into Switchy's MCP settings. Check your Folk workspace settings under Integrations or API to create a key. Without admin access, ask your workspace owner to provision one for you.

Can the Folk MCP update custom fields on contacts?

Yes. The MCP includes a tool to list custom fields for any group and entity type, so agents can read field schemas and write values back. This works for both person and company records. If your team uses custom fields for deal stage, lead source, or tags, agents can update them programmatically based on conversation context or external data.

How does this compare to using Folk's web app directly?

The web app is faster for ad-hoc lookups or manual data entry. The MCP is better when you want AI to handle repetitive CRM tasks—like enriching 50 contacts from a spreadsheet, deduplicating companies, or pulling relationship histories into a brief. You're trading Folk's UI polish for automation and cross-tool workflows inside Switchy.

Who on my team should connect the Folk MCP?

Whoever owns your CRM data hygiene or needs to automate contact workflows. Sales ops, RevOps, or a team lead are typical owners. Since the MCP can delete records irreversibly, limit API key access to people who understand the consequences. Each Switchy user can connect their own Folk workspace if your team uses separate CRM instances.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.