Manage Salesforce CRM from Your AI Agent with the Salesforce Skill

Ever wished you could query your Salesforce data, create leads, or manage contacts without leaving your terminal? The Salesforce skill for Clawdbot makes your AI agent a CRM power user—querying records with SOQL, managing sObjects, and performing batch operations, all through natural conversation.

Who Is This For?

If you're a sales team member, CRM administrator, or developer who spends time jumping between Salesforce and your terminal, this skill eliminates that context switching. Your AI agent becomes a bridge to your CRM data—pull reports, update records, or automate repetitive data tasks without touching the Salesforce UI.

Installation

Getting started takes one command:

npx clawhub@latest install salesforce-api

Configuration

The skill routes requests through Maton, which handles OAuth authentication with Salesforce. Here's how to set it up:

1. Get your Maton API key:

• Sign up or log in at maton.ai
• Navigate to maton.ai/settings
• Copy your API key

2. Set the environment variable:

export MATON_API_KEY="your_api_key_here"

3. Connect your Salesforce account: Create a new OAuth connection by running this Python snippet (or ask your agent to do it):

import urllib.request, os, json
data = json.dumps({'app': 'salesforce'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') 
req.add_header('Content-Type', 'application/json')
result = json.load(urllib.request.urlopen(req))
print(f"Open this URL to authorize: {result['connection']['url']}")

Open the returned URL in your browser to complete OAuth authorization.

Usage Examples

Query Contacts with SOQL

Ask your agent: "Find all contacts with Gmail addresses"

The skill executes:

Create a New Lead

"Create a lead for John Smith at Acme Corp, email john@acme.com"

# The agent sends:
POST /salesforce/services/data/v59.0/sobjects/Lead
{
  "FirstName": "John",
  "LastName": "Smith", 
  "Company": "Acme Corp",
  "Email": "john@acme.com"
}

Batch Operations

Need to update multiple records? The skill supports composite requests:

"Update phone numbers for these three contacts: [IDs and numbers]"

POST /salesforce/services/data/v59.0/composite/sobjects
{
  "allOrNone": true,
  "records": [
    {"attributes": {"type": "Contact"}, "Id": "003XXX", "Phone": "+1234567890"},
    {"attributes": {"type": "Contact"}, "Id": "003YYY", "Phone": "+0987654321"}
  ]
}

Tips & Best Practices

Start with queries. Before automating creates/updates, get comfortable querying your data. Ask your agent to "describe the Contact object" to see available fields.

Use the API limits endpoint. Before batch operations, check GET /services/data/v59.0/limits to ensure you have headroom.

Leverage SOSL for search. When you need fuzzy matching across objects, SOSL (Salesforce Object Search Language) beats SOQL. Ask your agent to "search for 'acme' across all objects."

Multiple connections? If you manage multiple Salesforce orgs, each gets its own connection. Specify which one with the Maton-Connection header or tell your agent which org you mean.

Watch for rate limits. The gateway allows 10 requests/second per account—plenty for interactive use, but be mindful with batch scripts.

Conclusion

The Salesforce skill transforms your Clawdbot into a CRM assistant that speaks SOQL. Whether you're pulling quick reports, automating lead entry, or managing contacts at scale, your agent handles the API complexity while you stay focused on the work that matters.

Links:

• Skill on ClawdHub
• Salesforce REST API Docs
• Maton Gateway