# Folk — MCP server on mcp.ai
> Connect your Folk account and use 23 tools for CRM straight from your AI agent. Connect with your own API key. folk is a next-generation CRM designed for teams to manage and nurture their relationships efficiently.

By: mcp.ai · official
Page: https://mcp.ai/folk

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_folk?ms=1787291520000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/folk/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/folk/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/folk/skill.md
Postman collection (v2.1): https://mcp.ai/folk/postman.json

## Tools
- folk_create_company(name: string, urls?: string[], emails?: string[], groups?: object[], phones?: string[], industry?: string, addresses?: string[], description?: string, employeeRange?: string, fundingRaised?: integer|number, foundationYear?: string, lastFundingDate?: string, customFieldValues?: object) — Creates a new company in the Folk workspace with the specified details. Required: company name (unique identifier). Optional: description, industry, funding details, employee range, contact info (emai
- folk_create_note(entity: object, content: string, parentNote?: object, visibility: string) — Tool to create a new note in the Folk workspace. Use when you need to add a note to a person, company, or deal entity.
- folk_create_person(emails?: string[], groups?: object[], phones?: string[], lastName?: string, firstName?: string, customFieldValues?: object) — Creates a new person in the Folk workspace with the specified details. Optional fields include: first name, last name, emails, phones, group assignments, and custom field values. The first email/phone
- folk_delete_company(company_id: string) — Tool to delete a company from the workspace (irreversible). Use after confirming this company should be removed.
- folk_delete_note(note_id: string) — Tool to delete an existing note in the workspace (irreversible). Use after confirming this note should be permanently removed.
- folk_delete_person(person_id: string) — Tool to delete an existing person in the workspace (irreversible). Use after confirming this person should be permanently removed.
- folk_delete_reminder(reminder_id: string) — Tool to delete an existing reminder in the workspace (irreversible). Use after confirming this reminder should be permanently removed.
- folk_get_company(company_id: string) — Tool to retrieve an existing company by its ID. Use after authentication has been verified.
- folk_get_current_workspace_user() — Tool to get details of the current authenticated workspace user. Use after authentication to retrieve the user's profile information.
- folk_get_note(note_id: string) — Tool to retrieve an existing note by its ID. Use when you need the full content and metadata of a specific note.
- folk_get_person(person_id: string) — Tool to retrieve an existing person by their ID. Use when you need full profile details of a person by their unique identifier.
- folk_get_user(user_id: string) — Tool to retrieve a user by their unique identifier. Use when you need to get details of a specific workspace user.
- folk_list_companies(limit?: integer, cursor?: string, filter?: object, combinator?: string) — Tool to list companies in the workspace. Use when you need a paginated overview of companies, optionally filtered.
- folk_list_group_custom_fields(limit?: integer, cursor?: string, group_id: string, entity_type: string) — 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.
- folk_list_groups(limit?: integer, cursor?: string) — Tool to list workspace groups. Use when you need to retrieve a paginated list of all workspace groups after authentication.
- folk_list_notes(limit?: integer, cursor?: string) — Tool to list notes in the workspace. Use when you need to retrieve notes with pagination support.
- folk_list_people(limit?: integer, cursor?: string, filter?: object, combinator?: string) — Tool to list people in the workspace. Use when you need to paginate through contacts after authentication.
- folk_list_reminders(limit?: integer, cursor?: string, entity_id?: string) — Tool to list reminders in the workspace. Use when you need a paginated overview of reminders, optionally filtered by entity.
- folk_list_users(limit?: integer, cursor?: string) — Tool to list workspace users. Use when you need to paginate through users list.
- folk_list_webhooks(limit?: integer, cursor?: string) — Tool to list webhooks in the workspace. Use when you need to retrieve configured webhooks with pagination support.
- folk_update_company(name?: string, urls?: string[], emails?: string[], groups?: object[], phones?: string[], addresses?: string[], companyId: string, description?: string, customFieldValues?: object) — 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.
- folk_update_note(content?: string, note_id: string, visibility?: string) — Tool to update an existing note in the workspace. Use after confirming the note ID; only provided fields are updated.
- folk_update_person(urls?: string[], emails?: string[], groups?: object[], phones?: string[], birthday?: string, fullName?: string, jobTitle?: string, lastName?: string, personId: string, addresses?: string[], companies?: object[], firstName?: string, description?: string, customFieldValues?: object) — Tool to update an existing person in the workspace. Use after confirming the person ID; only provided fields are updated and list fields replace existing values.

## Example prompts
- "What can I do in Folk?"
- "Show me a summary of my Folk account"

## Links
Docs: https://mcp.ai/docs/mcps/folk
Website: https://mcp.ai/mcps/folk