# Folk MCP by usefulapi

> Folk MCP by usefulapi is a freemium MCP server for sales and crm. Hosted MCP server that lets AI assistants read and write Folk CRM contacts, companies. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, vscode
- **Website:** https://usefulapi.io/folk/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/folk
- **MCP Registry name:** io.usefulapi/folk
- **Categories:** sales and CRM
- **Listing updated:** 2026-11-18

## About

Folk MCP is a hosted remote server from usefulapi that connects an AI client to a Folk CRM workspace. Instead of installing anything locally, you add a single URL to a supported client, sign in through a login page with your Folk API key, and the assistant can then look up people, companies, groups and notes or create and update them on your behalf.

The server exposes 18 tools in total. Nine are read-only, covering listing and fetching people, companies, groups, notes and workspace users. Five can create or change data: new people, new companies, updates to existing records and new notes. The remaining four handle usage status, subscription upgrades and cancellation, and sending feature requests. The README notes that clients should ask for confirmation before write tools run.

The service suits sales and relationship teams that keep their contacts in Folk and want to query or tidy them from Claude, ChatGPT, Cursor, VS Code or another MCP client. usefulapi states it is an independent service and not affiliated with Folk.

## Features

- **Hosted remote endpoint:** Runs as a Streamable HTTP server, so there is nothing to install and no local config file to maintain.
- **OAuth sign-in with Folk key:** Clients log in through a page that asks for your Folk API key, so credentials stay out of client config files.
- **Contact and company lookup:** Lists and filters people and companies, and fetches individual records by id.
- **Notes and groups access:** Reads notes by entity, full text or creation date, and lists groups used to place people and companies.
- **Create and update records:** Adds people, companies and notes and edits fields, with list fields such as emails replacing existing values.
- **Per-server usage meter:** Tracks monthly tool calls against a plan limit that can be checked with a usage status tool.

## Good for

- Pull a filtered list of contacts with their linked companies into a chat for review
- Summarise recent notes added to a Folk workspace over the last month
- Compare company records by industry and employee range before a sales call
- Add new contacts or companies from details pasted into the assistant
- Update contact fields or attach a note to a person or company after a meeting

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http folk https://folk.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://folk.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "folk": {
      "url": "https://folk.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "folk": {
      "type": "http",
      "url": "https://folk.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "folk": {
      "serverUrl": "https://folk.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `folk_get_current_user`: Get the user associated with the current Folk API key.
- `folk_list_users`: List users in the Folk workspace (id, name, email).
- `folk_list_people`: List and filter people (contacts) with cursor pagination.
- `folk_get_person`: Get a single person (contact) by id.
- `folk_list_companies`: List and filter companies with cursor pagination.
- `folk_get_company`: Get a single company by id.
- `folk_list_groups`: List groups in the Folk workspace.
- `folk_list_notes`: List notes, optionally scoped to an entity or filtered by full text and creation date.
- `folk_get_note`: Get a single note by id.
- `folk_create_person`: Create a new person (contact).
- `folk_update_person`: Update fields on an existing person.
- `folk_create_company`: Create a new company.
- `folk_update_company`: Update fields on an existing company.
- `folk_create_note`: Create a note attached to a person or company.
- `folk_usage_status`: Report current usage against the plan limit.
- `folk_request_feature`: Send a request for a capability the Folk tools do not yet provide.
- `folk_upgrade`: Get a paid Pro or Pro+ plan via a Stripe Checkout link.
- `folk_cancel_subscription`: Cancel the Pro subscription at the end of the paid period.

## FAQ

### Is this an official Folk product?

No. The site states usefulapi is an independent service that is not affiliated with or endorsed by Folk.

### What do I need to connect?

The login page asks for your Folk API key, which you create under Folk Settings, API keys.

### Can the AI change my Folk data?

Yes, through five tools that create or change data. The site says most MCP clients ask you to approve a tool call before it runs.

### What does it cost?

The Free plan allows 50 tool calls per month. Pro is $9 per month or $90 per year with 10,000 calls, and Pro+ is $39 per month or $390 per year with 100,000 calls. Each subscription covers this Folk server only.

### Is Folk MCP by usefulapi free?

Folk MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Folk MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http folk https://folk.usefulapi.io/mcp

### What are the best alternatives to Folk MCP by usefulapi?

The closest alternatives to Folk MCP by usefulapi are Calven, CompanyData, MisarReach MCP Server, NeuralVerge and ZUUZ.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [ZUUZ](https://ai-powered.com/mcp/zuuz): ZUUZ is an MCP server for sales and crm.
- [Fuse](https://ai-powered.com/mcp/fuse-2): Fuse is a freemium MCP server for sales and crm.
- [Gender-API.com](https://ai-powered.com/mcp/gender-api-com): Gender-API.com is a freemium MCP server for analytics and data.
- [Dialvett: Bulk Phone Number Validator & Carrier Lookup](https://ai-powered.com/mcp/dialvett-bulk-phone-number-validator-and-carrier-lookup): Dialvett: Bulk Phone Number Validator & Carrier Lookup is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/folk-mcp-by-usefulapi
