Folk MCP by usefulapi is an MCP server published by io.usefulapi, hosted at folk.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 14 tools, including folk_get_current_user, folk_list_users, folk_list_people, folk_get_person, folk_list_companies.
Read and write Folk CRM people, companies, groups and notes.
4,208 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Get the user associated with the current Folk API key. Folk REST: GET /v1/users/me.
No parameters.
{
"name": "folk_get_current_user",
"title": "Get current user",
"description": "Get the user associated with the current Folk API key. Folk REST: GET /v1/users/me.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get current user",
"readOnlyHint": true
}
}List users in the Folk workspace (id, name, email) — useful for resolving owner ids. Folk REST: GET /v1/users.
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page (1-100, default 20). |
| cursor | string | Pagination cursor — pass the value from a previous page's pagination.nextLink to fetch the next page. |
{
"name": "folk_list_users",
"title": "List users",
"description": "List users in the Folk workspace (id, name, email) — useful for resolving owner ids. Folk REST: GET /v1/users.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100, default 20)."
},
"cursor": {
"type": "string",
"description": "Pagination cursor — pass the value from a previous page's pagination.nextLink to fetch the next page."
}
}
},
"annotations": {
"title": "List users",
"readOnlyHint": true
}
}List/filter people (contacts). Supports cursor pagination and structured filters. Folk REST: GET /v1/people.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page (1-100, default 20). |
| cursor | string | Pagination cursor — pass the value from a previous page's pagination.nextLink to fetch the next page. |
| filter | object | Structured filter: attribute → operator → value, expanded to filter[attribute][operator]=value query keys. Example: {"firstName":{"eq":"John"}}. |
| combinator | string | How to combine multiple filters — 'and' (all must match) or 'or' (any). Default 'and'. |
{
"name": "folk_list_people",
"title": "List people",
"description": "List/filter people (contacts). Supports cursor pagination and structured filters. Folk REST: GET /v1/people.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100, default 20)."
},
"cursor": {
"type": "string",
"description": "Pagination cursor — pass the value from a previous page's pagination.nextLink to fetch the next page."
},
"filter": {
"type": "object",
"description": "Structured filter: attribute → operator → value, expanded to filter[attribute][operator]=value query keys. Example: {\"firstName\":{\"eq\":\"John\"}}.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"combinator": {
"enum": [
"and",
"or"
],
"type": "string",
"description": "How to combine multiple filters — 'and' (all must match) or 'or' (any). Default 'and'."
}
}
},
"annotations": {
"title": "List people",
"readOnlyHint": true
}
}Get a single person (contact) by id. Folk REST: GET /v1/people/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The person id. |
{
"name": "folk_get_person",
"title": "Get person",
"description": "Get a single person (contact) by id. Folk REST: GET /v1/people/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The person id."
}
}
},
"annotations": {
"title": "Get person",
"readOnlyHint": true
}
}List/filter companies. Supports cursor pagination and structured filters. Folk REST: GET /v1/companies.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page (1-100, default 20). |
| cursor | string | Pagination cursor — pass the value from a previous page's pagination.nextLink to fetch the next page. |
| filter | object | Structured filter: attribute → operator → value, expanded to filter[attribute][operator]=value query keys. Example: {"firstName":{"eq":"John"}}. |
| combinator | string | How to combine multiple filters — 'and' (all must match) or 'or' (any). Default 'and'. |
{
"name": "folk_list_companies",
"title": "List companies",
"description": "List/filter companies. Supports cursor pagination and structured filters. Folk REST: GET /v1/companies.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100, default 20)."
},
"cursor": {
"type": "string",
"description": "Pagination cursor — pass the value from a previous page's pagination.nextLink to fetch the next page."
},
"filter": {
"type": "object",
"description": "Structured filter: attribute → operator → value, expanded to filter[attribute][operator]=value query keys. Example: {\"firstName\":{\"eq\":\"John\"}}.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"combinator": {
"enum": [
"and",
"or"
],
"type": "string",
"description": "How to combine multiple filters — 'and' (all must match) or 'or' (any). Default 'and'."
}
}
},
"annotations": {
"title": "List companies",
"readOnlyHint": true
}
}Get a single company by id. Folk REST: GET /v1/companies/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The company id. |
{
"name": "folk_get_company",
"title": "Get company",
"description": "Get a single company by id. Folk REST: GET /v1/companies/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The company id."
}
}
},
"annotations": {
"title": "Get company",
"readOnlyHint": true
}
}List groups in the Folk workspace (ids needed to place people/companies). Folk REST: GET /v1/groups.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page (1-100, default 20). |
| cursor | string | Pagination cursor — pass the value from a previous page's pagination.nextLink to fetch the next page. |
{
"name": "folk_list_groups",
"title": "List groups",
"description": "List groups in the Folk workspace (ids needed to place people/companies). Folk REST: GET /v1/groups.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100, default 20)."
},
"cursor": {
"type": "string",
"description": "Pagination cursor — pass the value from a previous page's pagination.nextLink to fetch the next page."
}
}
},
"annotations": {
"title": "List groups",
"readOnlyHint": true
}
}List notes, optionally scoped to an entity or filtered by full text and creation date. Folk REST: GET /v1/notes.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page (1-100, default 20). |
| query | string | Full-text search over note content. |
| cursor | string | Pagination cursor — pass the value from a previous page's pagination.nextLink to fetch the next page. |
| entity_id | string | Restrict to notes on this entity (person/company) id — maps to query key entity.id. |
| created_after | string | Only notes created after this ISO 8601 timestamp — maps to query createdAfter. |
| created_before | string | Only notes created before this ISO 8601 timestamp — maps to query createdBefore. |
{
"name": "folk_list_notes",
"title": "List notes",
"description": "List notes, optionally scoped to an entity or filtered by full text and creation date. Folk REST: GET /v1/notes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100, default 20)."
},
"query": {
"type": "string",
"description": "Full-text search over note content."
},
"cursor": {
"type": "string",
"description": "Pagination cursor — pass the value from a previous page's pagination.nextLink to fetch the next page."
},
"entity_id": {
"type": "string",
"description": "Restrict to notes on this entity (person/company) id — maps to query key entity.id."
},
"created_after": {
"type": "string",
"description": "Only notes created after this ISO 8601 timestamp — maps to query createdAfter."
},
"created_before": {
"type": "string",
"description": "Only notes created before this ISO 8601 timestamp — maps to query createdBefore."
}
}
},
"annotations": {
"title": "List notes",
"readOnlyHint": true
}
}Get a single note by id. Folk REST: GET /v1/notes/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The note id. |
{
"name": "folk_get_note",
"title": "Get note",
"description": "Get a single note by id. Folk REST: GET /v1/notes/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The note id."
}
}
},
"annotations": {
"title": "Get note",
"readOnlyHint": true
}
}Create a new person (contact). All fields are optional. Folk REST: POST /v1/people.
| Parameter | Type | Description |
|---|---|---|
| urls | array | URLs (website, social, etc.). |
| emails | array | Email addresses. |
| gender | string | Gender — one of Male, Female, Unknown, Other. |
| groups | array | Groups to add this person to (array of {id}). |
| phones | array | Phone numbers. |
| birthday | string | Birthday, formatted YYYY-MM-DD. |
| fullName | string | Full name (if not split into first/last). |
| jobTitle | string | Job title. |
| lastName | string | Last name. |
| addresses | array | Postal addresses. |
| companies | array | Companies this person is linked to (array of {id} or {name}). |
| firstName | string | First name. |
| description | string | Freeform description / notes. |
| customFieldValues | object | Custom field values, keyed by field. |
{
"name": "folk_create_person",
"title": "Create person",
"description": "Create a new person (contact). All fields are optional. Folk REST: POST /v1/people.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs (website, social, etc.)."
},
"emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Email addresses."
},
"gender": {
"enum": [
"Male",
"Female",
"Unknown",
"Other"
],
"type": "string",
"description": "Gender — one of Male, Female, Unknown, Other."
},
"groups": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The group id."
}
},
"description": "A reference to a group by id."
},
"description": "Groups to add this person to (array of {id})."
},
"phones": {
"type": "array",
"items": {
"type": "string"
},
"description": "Phone numbers."
},
"birthday": {
"type": "string",
"description": "Birthday, formatted YYYY-MM-DD."
},
"fullName": {
"type": "string",
"description": "Full name (if not split into first/last)."
},
"jobTitle": {
"type": "string",
"description": "Job title."
},
"lastName": {
"type": "string",
"description": "Last name."
},
"addresses": {
"type": "array",
"items": {
"type": "string"
},
"description": "Postal addresses."
},
"companies": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The company id."
}
}
},
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The company name (creates/links by name)."
}
}
}
],
"description": "A reference to a company by id or by name."
},
"description": "Companies this person is linked to (array of {id} or {name})."
},
"firstName": {
"type": "string",
"description": "First name."
},
"description": {
"type": "string",
"description": "Freeform description / notes."
},
"customFieldValues": {
"type": "object",
"description": "Custom field values, keyed by field.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"annotations": {
"title": "Create person",
"destructiveHint": true
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The person id to update. |
| urls | array | Replace the person's URLs. |
| emails | array | Replace the person's email addresses. |
| gender | string | Gender — one of Male, Female, Unknown, Other. |
| groups | array | Replace the person's groups (array of {id}). |
| phones | array | Replace the person's phone numbers. |
| birthday | string | Birthday, formatted YYYY-MM-DD. |
| fullName | string | Full name. |
| jobTitle | string | Job title. |
| lastName | string | Last name. |
| addresses | array | Replace the person's addresses. |
| companies | array | Replace the person's linked companies (array of {id} or {name}). |
| firstName | string | First name. |
| description | string | Freeform description / notes. |
| customFieldValues | object | Custom field values, keyed by field. |
{
"name": "folk_update_person",
"title": "Update person",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The person id to update."
},
"urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Replace the person's URLs."
},
"emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Replace the person's email addresses."
},
"gender": {
"enum": [
"Male",
"Female",
"Unknown",
"Other"
],
"type": "string",
"description": "Gender — one of Male, Female, Unknown, Other."
},
"groups": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The group id."
}
},
"description": "A reference to a group by id."
},
"description": "Replace the person's groups (array of {id})."
},
"phones": {
"type": "array",
"items": {
"type": "string"
},
"description": "Replace the person's phone numbers."
},
"birthday": {
"type": "string",
"description": "Birthday, formatted YYYY-MM-DD."
},
"fullName": {
"type": "string",
"description": "Full name."
},
"jobTitle": {
"type": "string",
"description": "Job title."
},
"lastName": {
"type": "string",
"description": "Last name."
},
"addresses": {
"type": "array",
"items": {
"type": "string"
},
"description": "Replace the person's addresses."
},
"companies": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The company id."
}
}
},
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The company name (creates/links by name)."
}
}
}
],
"description": "A reference to a company by id or by name."
},
"description": "Replace the person's linked companies (array of {id} or {name})."
},
"firstName": {
"type": "string",
"description": "First name."
},
"description": {
"type": "string",
"description": "Freeform description / notes."
},
"customFieldValues": {
"type": "object",
"description": "Custom field values, keyed by field.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"annotations": {
"title": "Update person",
"destructiveHint": true
}
}Create a new company. `name` is required. Folk REST: POST /v1/companies.
| Parameter | Type | Description |
|---|---|---|
| name * | string | The company name (required). |
| urls | array | URLs (website, social, etc.). |
| emails | array | Email addresses. |
| groups | array | Groups to add this company to (array of {id}). |
| phones | array | Phone numbers. |
| industry | string | Industry. |
| addresses | array | Postal addresses. |
| description | string | Freeform description / notes. |
| employeeRange | string | Employee-count range bucket. |
| fundingRaised | ["string","number"] | Total funding raised. |
| foundationYear | ["string","number"] | Year the company was founded. |
| lastFundingDate | string | Date of last funding round, formatted YYYY-MM-DD. |
| customFieldValues | object | Custom field values, keyed by field. |
{
"name": "folk_create_company",
"title": "Create company",
"description": "Create a new company. `name` is required. Folk REST: POST /v1/companies.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The company name (required)."
},
"urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs (website, social, etc.)."
},
"emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Email addresses."
},
"groups": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The group id."
}
},
"description": "A reference to a group by id."
},
"description": "Groups to add this company to (array of {id})."
},
"phones": {
"type": "array",
"items": {
"type": "string"
},
"description": "Phone numbers."
},
"industry": {
"type": "string",
"description": "Industry."
},
"addresses": {
"type": "array",
"items": {
"type": "string"
},
"description": "Postal addresses."
},
"description": {
"type": "string",
"description": "Freeform description / notes."
},
"employeeRange": {
"enum": [
"1-10",
"11-50",
"51-200",
"201-500",
"501-1000",
"1001-5000",
"5001-10000",
"10000+"
],
"type": "string",
"description": "Employee-count range bucket."
},
"fundingRaised": {
"type": [
"string",
"number"
],
"description": "Total funding raised."
},
"foundationYear": {
"type": [
"string",
"number"
],
"description": "Year the company was founded."
},
"lastFundingDate": {
"type": "string",
"description": "Date of last funding round, formatted YYYY-MM-DD."
},
"customFieldValues": {
"type": "object",
"description": "Custom field values, keyed by field.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"annotations": {
"title": "Create company",
"destructiveHint": true
}
}Update fields on an existing company. Only provided fields are changed; list-valued fields REPLACE the existing values. Folk REST: PATCH /v1/companies/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The company id to update. |
| name | string | The company name. |
| urls | array | Replace the company's URLs. |
| emails | array | Replace the company's email addresses. |
| groups | array | Replace the company's groups (array of {id}). |
| phones | array | Replace the company's phone numbers. |
| industry | string | Industry. |
| addresses | array | Replace the company's addresses. |
| description | string | Freeform description / notes. |
| employeeRange | string | Employee-count range bucket. |
| fundingRaised | ["string","number"] | Total funding raised. |
| foundationYear | ["string","number"] | Year the company was founded. |
| lastFundingDate | string | Date of last funding round, formatted YYYY-MM-DD. |
| customFieldValues | object | Custom field values, keyed by field. |
{
"name": "folk_update_company",
"title": "Update company",
"description": "Update fields on an existing company. Only provided fields are changed; list-valued fields REPLACE the existing values. Folk REST: PATCH /v1/companies/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The company id to update."
},
"name": {
"type": "string",
"description": "The company name."
},
"urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Replace the company's URLs."
},
"emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Replace the company's email addresses."
},
"groups": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The group id."
}
},
"description": "A reference to a group by id."
},
"description": "Replace the company's groups (array of {id})."
},
"phones": {
"type": "array",
"items": {
"type": "string"
},
"description": "Replace the company's phone numbers."
},
"industry": {
"type": "string",
"description": "Industry."
},
"addresses": {
"type": "array",
"items": {
"type": "string"
},
"description": "Replace the company's addresses."
},
"description": {
"type": "string",
"description": "Freeform description / notes."
},
"employeeRange": {
"enum": [
"1-10",
"11-50",
"51-200",
"201-500",
"501-1000",
"1001-5000",
"5001-10000",
"10000+"
],
"type": "string",
"description": "Employee-count range bucket."
},
"fundingRaised": {
"type": [
"string",
"number"
],
"description": "Total funding raised."
},
"foundationYear": {
"type": [
"string",
"number"
],
"description": "Year the company was founded."
},
"lastFundingDate": {
"type": "string",
"description": "Date of last funding round, formatted YYYY-MM-DD."
},
"customFieldValues": {
"type": "object",
"description": "Custom field values, keyed by field.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"annotations": {
"title": "Update company",
"destructiveHint": true
}
}Create a note attached to an entity (person/company). Folk REST: POST /v1/notes.
| Parameter | Type | Description |
|---|---|---|
| content * | string | The note content. |
| entity_id * | string | Id of the entity (person/company) to attach the note to — maps to body entity:{id}. |
| visibility * | string | Note visibility — 'public' (workspace) or 'private' (you). |
| parent_note_id | string | Id of a parent note to reply under — maps to body parentNote:{id}. |
{
"name": "folk_create_note",
"title": "Create note",
"description": "Create a note attached to an entity (person/company). Folk REST: POST /v1/notes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"entity_id",
"visibility",
"content"
],
"properties": {
"content": {
"type": "string",
"description": "The note content."
},
"entity_id": {
"type": "string",
"description": "Id of the entity (person/company) to attach the note to — maps to body entity:{id}."
},
"visibility": {
"enum": [
"public",
"private"
],
"type": "string",
"description": "Note visibility — 'public' (workspace) or 'private' (you)."
},
"parent_note_id": {
"type": "string",
"description": "Id of a parent note to reply under — maps to body parentNote:{id}."
}
}
},
"annotations": {
"title": "Create note",
"destructiveHint": true
}
}Tools for Folk, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Show 20 contacts with their names, email addresses and linked companies."; "Show all notes added to my workspace in the last month."; "List my companies together with their industry and employee range.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Folk data. Free plan: 50 tool calls per month. Run folk_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run folk_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run folk_upgrade without a plan: it returns both plans, each with a payment link for the user to open. folk_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.