Skip to content

Folk MCP by usefulapi

by usefulapi.io · remote · no sign-in to list tools · v1.16.3 · published by io.usefulapi

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

Deletes · 5
CompareRegistry entry

14 tools: 5 can delete or cancel things and 9 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

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

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

14 tools

Deletes or cancels 5Claude Code: deny
  • folk_create_companyCreate a new company.No findings

    Why it is in this group

    • The name "folk_create_company" says "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Create a new company. `name` is required. Folk REST: POST /v1/companies.

    Annotations the server declares

    • title: Create company
    • destructiveHint: true
  • folk_create_noteCreate a note attached to an entity (person/company).No findings

    Why it is in this group

    • The name "folk_create_note" says "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Create a note attached to an entity (person/company). Folk REST: POST /v1/notes.

    Annotations the server declares

    • title: Create note
    • destructiveHint: true
  • folk_create_personCreate a new person (contact).No findings

    Why it is in this group

    • The name "folk_create_person" says "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Create a new person (contact). All fields are optional. Folk REST: POST /v1/people.

    Annotations the server declares

    • title: Create person
    • destructiveHint: true
  • folk_update_companyUpdate fields on an existing company.No findings

    Why it is in this group

    • The name "folk_update_company" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Update fields on an existing company. Only provided fields are changed; list-valued fields REPLACE the existing values. Folk REST: PATCH /v1/companies/{id}.

    Annotations the server declares

    • title: Update company
    • destructiveHint: true
  • folk_update_personUpdate fields on an existing person.No findings

    Why it is in this group

    • The name "folk_update_person" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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}.

    Annotations the server declares

    • title: Update person
    • destructiveHint: true
Only reads 9Claude Code: allow
  • folk_get_companyGet a single company by id.No findings

    Why it is in this group

    • The name "folk_get_company" says "get": a word for reading.
    Description, as the server wrote it
    Get a single company by id. Folk REST: GET /v1/companies/{id}.

    Annotations the server declares

    • title: Get company
    • readOnlyHint: true
  • folk_get_current_userGet the user associated with the current Folk API key.No findings

    Why it is in this group

    • The name "folk_get_current_user" says "get": a word for reading.
    Description, as the server wrote it
    Get the user associated with the current Folk API key. Folk REST: GET /v1/users/me.

    Annotations the server declares

    • title: Get current user
    • readOnlyHint: true
  • folk_get_noteGet a single note by id.No findings

    Why it is in this group

    • The name "folk_get_note" says "get": a word for reading.
    Description, as the server wrote it
    Get a single note by id. Folk REST: GET /v1/notes/{id}.

    Annotations the server declares

    • title: Get note
    • readOnlyHint: true
  • folk_get_personGet a single person (contact) by id.No findings

    Why it is in this group

    • The name "folk_get_person" says "get": a word for reading.
    Description, as the server wrote it
    Get a single person (contact) by id. Folk REST: GET /v1/people/{id}.

    Annotations the server declares

    • title: Get person
    • readOnlyHint: true
  • folk_list_companiesList/filter companies.No findings

    Why it is in this group

    • The name "folk_list_companies" says "list": a word for reading.
    Description, as the server wrote it
    List/filter companies. Supports cursor pagination and structured filters. Folk REST: GET /v1/companies.

    Annotations the server declares

    • title: List companies
    • readOnlyHint: true
  • folk_list_groupsList groups in the Folk workspace (ids needed to place people/companies).No findings

    Why it is in this group

    • The name "folk_list_groups" says "list": a word for reading.
    Description, as the server wrote it
    List groups in the Folk workspace (ids needed to place people/companies). Folk REST: GET /v1/groups.

    Annotations the server declares

    • title: List groups
    • readOnlyHint: true
  • folk_list_notesList notes, optionally scoped to an entity or filtered by full text and creation date.No findings

    Why it is in this group

    • The name "folk_list_notes" says "list": a word for reading.
    Description, as the server wrote it
    List notes, optionally scoped to an entity or filtered by full text and creation date. Folk REST: GET /v1/notes.

    Annotations the server declares

    • title: List notes
    • readOnlyHint: true
  • folk_list_peopleList/filter people (contacts).No findings

    Why it is in this group

    • The name "folk_list_people" says "list": a word for reading.
    Description, as the server wrote it
    List/filter people (contacts). Supports cursor pagination and structured filters. Folk REST: GET /v1/people.

    Annotations the server declares

    • title: List people
    • readOnlyHint: true
  • folk_list_usersList users in the Folk workspace (id, name, email) — useful for resolving owner ids.No findings

    Why it is in this group

    • The name "folk_list_users" says "list": a word for reading.
    Description, as the server wrote it
    List users in the Folk workspace (id, name, email) — useful for resolving owner ids. Folk REST: GET /v1/users.

    Annotations the server declares

    • title: List users
    • readOnlyHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.16.3. Values in angle brackets are yours to fill in.

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

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__folk__folk_get_current_user",
      "mcp__folk__folk_list_users",
      "mcp__folk__folk_list_people",
      "mcp__folk__folk_get_person",
      "mcp__folk__folk_list_companies",
      "mcp__folk__folk_get_company",
      "mcp__folk__folk_list_groups",
      "mcp__folk__folk_list_notes",
      "mcp__folk__folk_get_note"
    ],
    "ask": [],
    "deny": [
      "mcp__folk__folk_create_person",
      "mcp__folk__folk_update_person",
      "mcp__folk__folk_create_company",
      "mcp__folk__folk_update_company",
      "mcp__folk__folk_create_note"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as folk. Review it before you use it.