Folk MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.39.2Updated Nov 14, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server that lets an assistant read and write Folk CRM people, companies, groups and notes through OAuth sign-in.

What you can do
  • List and get people and companies, with cursor pagination and structured filters
  • List workspace users and groups to resolve owner ids and placement
  • List and read notes, scoped to an entity or filtered by full text and date
  • Create and update people and companies, and create notes attached to an entity
  • Check monthly usage, request a missing feature, and manage the Pro subscription
When to use it
Useful when you keep contacts, companies and meeting notes in Folk and want an assistant to look them up, summarize them, or add and update records without switching apps.
Requirements
Remote endpoint only, no local install. Connect with the server URL alone; sign-in uses OAuth and the login page asks for your Folk credentials, which are stored per user. No API key or Authorization header goes in the client config. Network access required.
Before you install
Write tools create and change Folk records, and list-valued fields such as emails, phones, groups and companies replace existing values rather than merge, so confirm before running them. Your Folk credentials are entered on the hosted login page and stored by the third-party provider. Free tier is 50 calls per month; paid plans are billed through Stripe, and plan changes or cancellations involve charges with no refund for the current period.

Installation

In SourceWeft

  1. Open Folk MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Ffolk/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "folk-by-usefulapi": {
      "type": "http",
      "url": "https://folk.usefulapi.io/mcp"
    }
  }
}

README

Folk MCP by usefulapi

Read and write Folk CRM people, companies, groups and notes. Hosted, no local install.

Live endpoint: https://folk.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://folk.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http folk https://folk.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "folk": {      "url": "https://folk.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Folk credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/folk/

On first connect you'll paste your Folk credentials. They are validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
folk_get_current_userreadGet current user
folk_list_usersreadList users
folk_list_peoplereadList people
folk_get_personreadGet person
folk_list_companiesreadList companies
folk_get_companyreadGet company
folk_list_groupsreadList groups
folk_list_notesreadList notes
folk_get_notereadGet note
folk_create_personwriteCreate person
folk_update_personwriteUpdate person
folk_create_companywriteCreate company
folk_update_companywriteUpdate company
folk_create_notewriteCreate note
folk_usage_statusmetaUsage status (free-tier meter)
folk_request_featuremetaRequest a missing feature
folk_upgrademetaUpgrade to Pro or Pro+
folk_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run folk_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with folk_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with folk_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT

Source: servers/folk/README.md at commit f22f848

Tools

14

folk_get_current_user

Get current user

Get the user associated with the current Folk API key. Folk REST: GET /v1/users/me.

Takes no parameters.

folk_list_users

List users

List users in the Folk workspace (id, name, email) — useful for resolving owner ids. Folk REST: GET /v1/users.

Parameterslimitcursor

folk_list_people

List people

List/filter people (contacts). Supports cursor pagination and structured filters. Folk REST: GET /v1/people.

Parameterslimitcursorfiltercombinator

folk_get_person

Get person

Get a single person (contact) by id. Folk REST: GET /v1/people/{id}.

Parametersidrequired

folk_list_companies

List companies

List/filter companies. Supports cursor pagination and structured filters. Folk REST: GET /v1/companies.

Parameterslimitcursorfiltercombinator

folk_get_company

Get company

Get a single company by id. Folk REST: GET /v1/companies/{id}.

Parametersidrequired

folk_list_groups

List groups

List groups in the Folk workspace (ids needed to place people/companies). Folk REST: GET /v1/groups.

Parameterslimitcursor

folk_list_notes

List notes

List notes, optionally scoped to an entity or filtered by full text and creation date. Folk REST: GET /v1/notes.

Parameterslimitquerycursorentity_idcreated_aftercreated_before

folk_get_note

Get note

Get a single note by id. Folk REST: GET /v1/notes/{id}.

Parametersidrequired

folk_create_person

Create person

Create a new person (contact). All fields are optional. Folk REST: POST /v1/people.

ParametersurlsemailsgendergroupsphonesbirthdayfullNamejobTitlelastNameaddressescompaniesfirstName+2 more

folk_update_person

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}.

ParametersidrequiredurlsemailsgendergroupsphonesbirthdayfullNamejobTitlelastNameaddressescompanies+3 more

folk_create_company

Create company

Create a new company. `name` is required. Folk REST: POST /v1/companies.

ParametersnamerequiredurlsemailsgroupsphonesindustryaddressesdescriptionemployeeRangefundingRaisedfoundationYearlastFundingDate+1 more

folk_update_company

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}.

ParametersidrequirednameurlsemailsgroupsphonesindustryaddressesdescriptionemployeeRangefundingRaisedfoundationYear+2 more

folk_create_note

Create note

Create a note attached to an entity (person/company). Folk REST: POST /v1/notes.

Parameterscontentrequiredentity_idrequiredvisibilityrequiredparent_note_id

Version history

26
  1. v1.39.2LatestNov 14, 2026
  2. v1.39.1Nov 13, 2026
  3. v1.38.0Nov 12, 2026
  4. v1.37.3Nov 11, 2026
  5. v1.36.5Nov 8, 2026
  6. v1.36.4Nov 7, 2026
  7. v1.35.3Nov 5, 2026
  8. v1.35.2Nov 5, 2026
  9. v1.35.1Nov 4, 2026
  10. v1.35.0Nov 3, 2026
  11. v1.34.1Nov 3, 2026
  12. v1.33.0Nov 1, 2026
  13. v1.31.0Oct 31, 2026
  14. v1.30.0Oct 31, 2026
  15. v1.29.2Oct 30, 2026
  16. v1.29.0Oct 30, 2026
  17. v1.24.0Oct 26, 2026
  18. v1.21.3Oct 25, 2026
  19. v1.21.0Oct 25, 2026
  20. v1.20.0Oct 24, 2026
  21. v1.17.0Oct 23, 2026
  22. v1.16.4Oct 22, 2026
  23. v1.16.3Oct 21, 2026
  24. v1.11.1Oct 9, 2026
  25. v1.10.0Oct 9, 2026
  26. v1.0.0Sep 29, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably that lets an assistant inspect realtime channels, presence and usage stats, publish messages, and review app configuration.

Streamable HTTPWeb executable
Communication & Collaboration15 toolsNov 14, 2026

ROLLER MCP by usefulapi

io.usefulapiOfficial publisher

Read-only access to ROLLER venue data: search bookings, check product availability, and look up guests, waivers, gift cards and daily reports.

Streamable HTTPWeb executable
Data & Analytics42 toolsNov 14, 2026

Planerio MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Planerio connector that lets an assistant read shifts, staffing requirements, staff, employees, absences and vacation days.

Streamable HTTPWeb executable
Productivity & Workflow6 toolsNov 14, 2026

Marmin MCP by usefulapi

io.usefulapiOfficial publisher

Read-only access to Marmin UAE e-invoicing data: invoices, credit notes, UBL XML, Peppol status and business profiles.

Streamable HTTPWeb executable
Finance10 toolsNov 14, 2026

Oyster MCP by usefulapi

io.usefulapiOfficial publisher

Remote MCP server for Oyster that lets an assistant read team, time off, expense, contract and invoice data and approve or decline requests.

Streamable HTTPWeb executable
Productivity & Workflow20 toolsNov 14, 2026