salesforce_learnLABSCO SUMMARY
It learns your org before it answers about it.
Salesforce orgs diverge hard — custom objects, renamed fields, per-company conventions — and a generic connector guesses. Running the learn step once means later queries use names that exist. The backup and time-machine pair is the other reason to look: it is unusual for an MCP server to give you a recoverable historical view rather than only the current record.
What it is
An MCP server for Salesforce that adapts to whatever org you connect: it discovers your schema dynamically, so custom objects and fields work like standard ones. Beyond CRUD it backs up data and files, and can read an earlier backup as it stood at a point in time.
What you get
- Records —
salesforce_query,salesforce_create,salesforce_update,salesforce_delete - Schema —
salesforce_describefor object and field detail, andsalesforce_learn, which analyses your complete Salesforce setup so later answers use your org's real objects and field names - Backup —
salesforce_backupcovers data and files including ContentVersions, Attachments and Documents with their metadata;salesforce_backup_listshows what exists;salesforce_time_machinereads a point in time out of them - Setup and diagnostics —
salesforce_authandsalesforce_installation_info - Authentication is browser-based OAuth with automatic token refresh, and Claude detects when it is needed rather than making you run a terminal step
Requirements
Node.js 18+ and a Salesforce Connected App with OAuth enabled. Set the callback URL to http://localhost:9876/callback and select the api and refresh_token/offline_access scopes; keep the Consumer Key and Consumer Secret. The recommended install is npx — put npx @aiondadotcom/mcp-salesforce in your client config and use the setup tool on first run to supply client ID, client secret and your instance URL. Credentials are written to ~/.mcp-salesforce.json with 600 permissions and the learned schema cache to ~/.mcp-salesforce-cache/. Package version 1.2.5.
Setup effort
One command plus credentials — npx @aiondadotcom/mcp-salesforce, then supply credentials
USE CASES
01
Asking questions that use your org's own field names
Run the learning pass once so the model queries against the objects and custom fields you actually have.
02
Fixing a record from the conversation
Query for the record, confirm the field with a describe, then apply the update.
03
Taking a backup that includes attachments
Run a backup covering data and the file systems, then confirm it in the backup list.
04
Checking what a record looked like before
Read the stored backups at a chosen point in time to see the earlier state.
11 tools
Listed in project docs. Your client may show a different list.
salesforce_installation_infosalesforce_querysalesforce_createsalesforce_updatesalesforce_deletesalesforce_describesalesforce_backupsalesforce_backup_listsalesforce_time_machinesalesforce_authBEFORE YOU INSTALL
What to know first
Tools you get
11 tools named in the project's documentation.
Requires
- npx on PATH
- Node.js 18+
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npx @aiondadotcom/mcp-salesforceMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"salesforce": {
"command": "npx",
"args": [
"@aiondadotcom/mcp-salesforce"
]
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"salesforce": {
"command": "npx",
"args": [
"@aiondadotcom/mcp-salesforce"
]
}
}
}
