Folk MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'folkmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Folk MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'folkmcp_folk_create_person',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "folkmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Folk MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="folkmcp_folk_create_person",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Create folk — Create a new company record in the Folk CRM workspace with native and custom field values
• Get folk — Retrieve a single company record from Folk CRM by its ID, including all native and custom fields
• Search folk — Search for companies in the Folk CRM workspace by name, domain, or custom field values
• Update folk — Update an existing company record in Folk CRM with new native or custom field values

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

folkmcp_folk_create_company#Create a new company record in the Folk CRM workspace with native and custom field values.3 params▾

Create a new company record in the Folk CRM workspace with native and custom field values.

NameTypeRequiredDescription

namestringrequiredCompany name.

customFieldsobjectoptionalCustom field values keyed by field name.

domainstringoptionalCompany domain (e.g. acme.com).

folkmcp_folk_create_object#Create a new custom object record in a Folk CRM group with specified field values.3 params▾

Create a new custom object record in a Folk CRM group with specified field values.

NameTypeRequiredDescription

namestringrequiredObject name or title.

objectTypestringrequiredThe type of custom object to create.

customFieldsobjectoptionalCustom field values keyed by field name.

folkmcp_folk_create_person#Create a new person (contact) record in the Folk CRM workspace with native and custom field values.4 params▾

Create a new person (contact) record in the Folk CRM workspace with native and custom field values.

NameTypeRequiredDescription

customFieldsobjectoptionalCustom field values keyed by field name.

emailstringoptionalPerson's email address.

firstNamestringoptionalPerson's first name.

lastNamestringoptionalPerson's last name.

folkmcp_folk_get_company#Retrieve a single company record from Folk CRM by its ID, including all native and custom fields.1 param▾

Retrieve a single company record from Folk CRM by its ID, including all native and custom fields.

NameTypeRequiredDescription

companyIdstringrequiredThe ID of the company to retrieve.

folkmcp_folk_get_current_user#Returns the identity of the authenticated folk user for this MCP session: their id, email, and fullName.0 params▾

Returns the identity of the authenticated folk user for this MCP session: their id, email, and fullName.

folkmcp_folk_get_object#Retrieve a single custom object record from Folk CRM by its ID, including all native and custom fields.3 params▾

Retrieve a single custom object record from Folk CRM by its ID, including all native and custom fields.

NameTypeRequiredDescription

groupIdstringrequiredThe group ID the object belongs to.

objectIdstringrequiredThe ID of the object to retrieve.

objectTypestringrequiredThe object type.

folkmcp_folk_get_person#Retrieve a single person (contact) record from Folk CRM by its ID, including all native and custom fields.1 param▾

Retrieve a single person (contact) record from Folk CRM by its ID, including all native and custom fields.

NameTypeRequiredDescription

personIdstringrequiredThe ID of the person to retrieve.

folkmcp_folk_get_workspace_structure#Retrieves the complete structure of the folk workspace: groups, entity types per group, native fields, custom field definitions, pipeline views, and workspace members.0 params▾

Retrieves the complete structure of the folk workspace: groups, entity types per group, native fields, custom field definitions, pipeline views, and workspace members.

folkmcp_folk_search_companies#Search for companies in the Folk CRM workspace by name, domain, or custom field values.1 param▾

Search for companies in the Folk CRM workspace by name, domain, or custom field values.

NameTypeRequiredDescription

filterobjectrequiredFilter criteria. Use field names as keys with operator objects as values. Example: {"name": {"contains": "Acme"}}

folkmcp_folk_search_objects#Search for custom objects in the Folk CRM workspace by name or custom field values within a specific group.3 params▾

Search for custom objects in the Folk CRM workspace by name or custom field values within a specific group.

NameTypeRequiredDescription

filterobjectrequiredFilter criteria keyed by field name with operator objects.

groupIdstringrequiredThe group ID to search within.

objectTypestringrequiredThe object type to search for.

folkmcp_folk_search_people#Search for people (contacts) in the Folk CRM workspace by name, email, or custom field values.1 param▾

Search for people (contacts) in the Folk CRM workspace by name, email, or custom field values.

NameTypeRequiredDescription

filterobjectrequiredFilter criteria. Use field names as keys with operator objects as values. Example: {"name": {"contains": "Jane"}}

folkmcp_folk_update_company#Update an existing company record in Folk CRM with new native or custom field values.4 params▾

Update an existing company record in Folk CRM with new native or custom field values.

NameTypeRequiredDescription

companyIdstringrequiredThe ID of the company to update.

customFieldsobjectoptionalCustom field values to update, keyed by field name.

domainstringoptionalUpdated company domain.

namestringoptionalUpdated company name.

folkmcp_folk_update_object#Update an existing custom object record in Folk CRM with new field values.4 params▾

Update an existing custom object record in Folk CRM with new field values.

NameTypeRequiredDescription

objectIdstringrequiredThe ID of the object to update.

objectTypestringrequiredThe type of custom object to update.

customFieldsobjectoptionalCustom field values to update, keyed by field name.

namestringoptionalUpdated object name or title.

folkmcp_folk_update_person#Update an existing person (contact) record in Folk CRM with new native or custom field values.5 params▾

Update an existing person (contact) record in Folk CRM with new native or custom field values.

NameTypeRequiredDescription

personIdstringrequiredThe ID of the person to update.

customFieldsobjectoptionalCustom field values to update, keyed by field name.

emailstringoptionalUpdated email address.

firstNamestringoptionalUpdated first name.

lastNamestringoptionalUpdated last name.