usefulapi

Folk MCP server. Read and write Folk CRM people, companies, groups and notes.

Claude

  1. Open Settings → Connectors → Add custom connector
  2. Paste this URL:
    https://folk.usefulapi.io/mcp
  3. Authenticate with Folk when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

{
  "mcpServers": {
    "folk": {
      "url": "https://folk.usefulapi.io/mcp"
    }
  }
}
live14 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 14

ToolTypeWhat it does
folk_get_current_userread
Get current user
Get the user associated with the current Folk API key. Folk REST: GET /v1/users/me.
folk_list_usersread
List users
List users in the Folk workspace (id, name, email) — useful for resolving owner ids. Folk REST: GET /v1/users.
folk_list_peopleread
List people
List/filter people (contacts). Supports cursor pagination and structured filters. Folk REST: GET /v1/people.
folk_get_personread
Get person
Get a single person (contact) by id. Folk REST: GET /v1/people/{id}.
folk_list_companiesread
List companies
List/filter companies. Supports cursor pagination and structured filters. Folk REST: GET /v1/companies.
folk_get_companyread
Get company
Get a single company by id. Folk REST: GET /v1/companies/{id}.
folk_list_groupsread
List groups
List groups in the Folk workspace (ids needed to place people/companies). Folk REST: GET /v1/groups.
folk_list_notesread
List notes
List notes, optionally scoped to an entity or filtered by full text and creation date. Folk REST: GET /v1/notes.
folk_get_noteread
Get note
Get a single note by id. Folk REST: GET /v1/notes/{id}.
folk_create_personwrite
Create person
Create a new person (contact). All fields are optional. Folk REST: POST /v1/people.
folk_update_personwrite
Update person
Update fields on an existing person. Only provided fields are changed; list-valued fields (emails, phones, groups, companies, etc.) REPLACE the existing values. Folk REST: PATCH /v1/people/{id}.
folk_create_companywrite
Create company
Create a new company. `name` is required. Folk REST: POST /v1/companies.
folk_update_companywrite
Update company
Update fields on an existing company. Only provided fields are changed; list-valued fields REPLACE the existing values. Folk REST: PATCH /v1/companies/{id}.
folk_create_notewrite
Create note
Create a note attached to an entity (person/company). Folk REST: POST /v1/notes.

Pricing

PlanPriceLimit
Free$0100 tool calls / month
Pro$9/mo · $90/yrUnlimited

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.