salesforce-automation — Claude Code skill: CRM operations via Rube MCP
The salesforce-automation skill automates Salesforce operations: create and search leads, contacts, accounts, opportunities, and run SOQL queries through Composio.
MIT 128 installs ★ 3,785 updated 2026-10-25
npx skills add davepoon/buildwithclaude --skill salesforce-automation -a claude-codeWhat salesforce-automation does
The skill connects to Salesforce tooling through Rube MCP and Composio. You get built-in operations for leads (search, create, update, add to campaigns), contacts and accounts, plus opportunity management — creation, searching, and detail retrieval. Task search and updates are included, along with arbitrary SOQL queries for complex data pulls.
To start, add https://rube.app/mcp as an MCP server in your editor config — no API keys needed, it works out of the box. Then activate a Salesforce connection via RUBE_MANAGE_CONNECTIONS with toolkit type salesforce and complete OAuth. The skill checks current tool schemas via RUBE_SEARCH_TOOLS before each operation.
Key constraint: field names must match Salesforce API names, not display labels. Lead creation requires LastName and Company. Opportunities need Name, StageName, and CloseDate. If your org has custom objects, fetch them with SALESFORCE_GET_ALL_CUSTOM_OBJECTS first. Stage names must match exactly what you configured in Salesforce.
What it helps with
- search and create leads in Salesforce from your code editor
- link contacts to accounts and manage contact records
- create opportunities, move them through sales stages, and update details
- run custom SOQL queries for analytics and complex data retrieval
- automate task workflows and apply assignment rules
Example prompts for the agent
- Find all leads with last name Smith and update their phone numbers
- Create a new opportunity called Product X, stage Proposal, amount $50k
- Write a SOQL query to get all contacts from Technology accounts with email addresses
How to install salesforce-automation
1Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill salesforce-automation -a claude-code2Manually: put the files in place
~/.claude/skills/salesforce-automation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/salesforce-automation/
1Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill salesforce-automation -a codex2Manually: put the files in place
.agents/skills/salesforce-automation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill salesforce-automation -a cursor2Manually: put the files in place
.cursor/skills/salesforce-automation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install davepoon/buildwithclaude plugins/all-skills/skills/salesforce-automation2Manually: put the files in place
.github/skills/salesforce-automation/SKILL.md1Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill salesforce-automation -a gemini-cli2Platform CLI
gemini skills install https://github.com/davepoon/buildwithclaude --path plugins/all-skills/skills/salesforce-automationManually: put the files in place
.devin/skills/salesforce-automation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill salesforce-automation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about salesforce-automation
How do I install salesforce-automation in Claude Code?
Run npx skills add davepoon/buildwithclaude --skill salesforce-automation -a claude-code, then check the file at ~/.claude/skills/salesforce-automation/SKILL.md.
What do I need to use this skill?
Rube MCP configured with https://rube.app/mcp, an active OAuth connection to Salesforce through RUBE_MANAGE_CONNECTIONS, and access to Composio's Salesforce toolkit. No API keys required.
Why does lead or contact creation fail?
Leads require LastName and Company fields; contacts require LastName. Verify field names use Salesforce API names (not display labels). Custom fields end with __c.
Source text
SKILL.md · MIT
--- name: salesforce-automation description: "Automate Salesforce tasks via Rube MCP (Composio): leads, contacts, accounts, opportunities, SOQL queries. Always search tools first for current schemas." requires: mcp: [rube] category: crm --- # Salesforce Automation via Rube MCP Automate Salesforce CRM operations through Composio's Salesforce toolkit via Rube MCP. **Toolkit docs**: [composio.dev/toolkits/salesforce](https://composio.dev/toolkits/salesforce) ## Prerequisites - Rube MCP must be connected (RUBE_SEARCH_TOOLS available) - Active Salesforce connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `salesforce` - Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas ## Setup **Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works. 1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds 2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `salesforce` 3. If connection is not ACTIVE, follow the returned auth link to complete Salesforce OAuth 4. Confirm connection status shows ACTIVE before running any workflows ## Core Workflows ### 1. Manage Leads **When to use**: User wants to create, search, update, or list leads **Tool sequence**: 1. `SALESFORCE_SEARCH_LEADS` - Search leads by criteria [Optional] 2. `SALESFORCE_LIST_LEADS` - List all leads [Optional] 3. `SALESFORCE_CREATE_LEAD` - Create a new lead [Optional] 4. `SALESFORCE_UPDATE_LEAD` - Update lead fields [Optional] 5. `SALESFORCE_ADD_LEAD_TO_CAMPAIGN` - Add lead to campaign [Optional] 6. `SALESFORCE_APPLY_LEAD_ASSIGNMENT_RULES` - Apply assignment rules [Optional] **Key parameters**: - `LastName`: Required for lead creation - `Company`: Required for lead creation - `Email`, `Phone`, `Title`: Common lead fields - `lead_id`: Lead ID for updates - `campaign_id`: Campaign ID for campaign operations **Pitfalls**: - LastName and Company are required fields for lead creation - Lead IDs are 15 or 18 character Salesforce IDs ### 2. Manage Contacts and Accounts **When to use**: User wants to manage contacts and their associated accounts **Tool sequence**: 1. `SALESFORCE_SEARCH_CONTACTS` - Search contacts [Optional] 2. `SALESFORCE_LIST_CONTACTS` - List contacts [Optional] 3. `SALESFORCE_CREATE_CONTACT` - Create a new contact [Optional] 4. `SALESFORCE_SEARCH_ACCOUNTS` - Search accounts [Optional] 5. `SALESFORCE_CREATE_ACCOUNT` - Create a new account [Optional] 6. `SALESFORCE_ASSOCIATE_CONTACT_TO_ACCOUNT` - Link contact to account [Optional] **Key parameters**: - `LastName`: Required for contact creation - `Name`: Account name for creation - `AccountId`: Account ID to associate with contact - `contact_id`, `account_id`: IDs for association **Pitfalls**: - Contact requires at least LastName - Account association requires both valid contact and account IDs ### 3. Manage Opportunities **When to use**: User wants to track and manage sales opportunities **Tool sequence**: 1. `SALESFORCE_SEARCH_OPPORTUNITIES` - Search opportunities [Optional] 2. `SALESFORCE_LIST_OPPORTUNITIES` - List all opportunities [Optional] 3. `SALESFORCE_GET_OPPORTUNITY` - Get opportunity details [Optional] 4. `SALESFORCE_CREATE_OPPORTUNITY` - Create new opportunity [Optional] 5. `SALESFORCE_RETRIEVE_OPPORTUNITIES_DATA` - Retrieve opportunity data [Optional] **Key parameters**: - `Name`: Opportunity name (required) - `StageName`: Sales stage (required) - `CloseDate`: Expected close date (required) - `Amount`: Deal value - `AccountId`: Associated account **Pitfalls**: - Name, StageName, and CloseDate are required for creation - Stage names must match exactly what is configured in Salesforce ### 4. Run SOQL Queries **When to use**: User wants to query Salesforce data with custom SOQL **Tool sequence**: 1. `SALESFORCE_RUN_SOQL_QUERY` / `SALESFORCE_QUERY` - Execute SOQL [Required] **Key parameters**: - `query`: SOQL query string **Pitfalls**: - SOQL syntax differs from SQL; uses Salesforce object and field API names - Field API names may differ from display labels (e.g., `Account.Name` not `Account Name`) - Results are paginated for large datasets ### 5. Manage Tasks **When to use**: User wants to create, search, update, or complete tasks **Tool sequence**: 1. `SALESFORCE_SEARCH_TASKS` - Search tasks [Optional] 2. `SALESFORCE_UPDATE_TASK` - Update task fields [Optional] 3. `SALESFORCE_COMPLETE_TASK` - Mark task as complete [Optional] **Key parameters**: - `task_id`: Task ID for updates - `Status`: Task status value - `Subject`: Task subject **Pitfalls**: - Task status values must match picklist options in Salesforce ## Common Patterns ### SOQL Syntax **Basic query**: ``` SELECT Id, Name, Email FROM Contact WHERE LastName = 'Smith' ``` **With relationships**: ``` SELECT Id, Name, Account.Name FROM Contact WHERE Account.Industry = 'Technology' ``` **Date filtering**: ``` SELECT Id, Name FROM Lead WHERE CreatedDate = TODAY SELECT Id, Name FROM Opportunity WHERE CloseDate = NEXT_MONTH ``` ### Pagination - SOQL queries with large results return pagination tokens - Use `SALESFORCE_QUERY` with nextRecordsUrl for pagination - Check `done` field in response; if false, continue paging ## Known Pitfalls **Field API Names**: - Always use API names, not display labels - Custom fields end with `__c` suffix - Use SALESFORCE_GET_ALL_CUSTOM_OBJECTS to discover custom objects **ID Formats**: - Salesforce IDs are 15 (case-sensitive) or 18 (case-insensitive) characters - Both formats are accepted in most operations ## Quick Reference | Task | Tool Slug | Key Params | |------|-----------|------------| | Create lead | SALESFORCE_CREATE_LEAD | LastName, Company | | Search leads | SALESFORCE_SEARCH_LEADS | query | | List leads | SALESFORCE_LIST_LEADS | (filters) | | Update lead | SALESFORCE_UPDATE_LEAD | lead_id, fields | | Create contact | SALESFORCE_CREATE_CONTACT | LastName | | Search contacts | SALESFORCE_SEARCH_CONTACTS | query | | Create account | SALESFORCE_CREATE_ACCOUNT | Name | | Search accounts | SALESFORCE_SEARCH_ACCOUNTS | query | | Link contact | SALESFORCE_ASSOCIATE_CONTACT_TO_ACCOUNT | contact_id, account_id | | Create opportunity | SALESFORCE_CREATE_OPPORTUNITY | Name, StageName, CloseDate | | Get opportunity | SALESFORCE_GET_OPPORTUNITY | opportunity_id | | Search opportunities | SALESFORCE_SEARCH_OPPORTUNITIES | query | | Run SOQL | SALESFORCE_RUN_SOQL_QUERY | query | | Query | SALESFORCE_QUERY | query | | Search tasks | SALESFORCE_SEARCH_TASKS | query | | Update task | SALESFORCE_UPDATE_TASK | task_id, fields | | Complete task | SALESFORCE_COMPLETE_TASK | task_id | | Get user info | SALESFORCE_GET_USER_INFO | (none) | | Custom objects | SALESFORCE_GET_ALL_CUSTOM_OBJECTS | (none) | | Create record | SALESFORCE_CREATE_A_RECORD | object_type, fields | | Transfer ownership | SALESFORCE_MASS_TRANSFER_OWNERSHIP | records, new_owner | --- *Powered by [Composio](https://composio.dev)*
© davepoon · MIT · davepoon/buildwithclaude