Salesforce MCP Server
The Salesforce MCP Server enables natural language interactions with Salesforce data and metadata through Claude integration, allowing you to:
Search for and manage standard and custom Salesforce objects and fields
Query records using SOQL with complex filters and relationship support
Perform data operations (insert, update, delete, upsert) on Salesforce records
Create and update custom objects and fields
Execute cross-object searches using SOSL (Salesforce Object Search Language)
Get detailed schema information and metadata for any object
Upload and manage Salesforce reports via XML
Manage sharing settings and relationships between objects
Enables querying, modifying, and managing Salesforce objects and records, with capabilities for object/field management, schema information retrieval, data querying with relationship support, record manipulation (insert, update, delete), and cross-object searching using SOSL.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Salesforce MCP Server show me the last 10 opportunities created this month"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Salesforce MCP Server
An MCP (Model Context Protocol) server implementation that integrates Claude with Salesforce, enabling natural language interactions with your Salesforce data and metadata. This server allows Claude to query, modify, and manage your Salesforce objects and records using everyday language.
Features
Object and Field Management: Create and modify custom objects and fields using natural language
Smart Object Search: Find Salesforce objects using partial name matches
Detailed Schema Information: Get comprehensive field and relationship details for any object
Flexible Data Queries: Query records with relationship support and complex filters
Data Manipulation: Insert, update, delete, and upsert records with ease
Cross-Object Search: Search across multiple objects using SOSL
Intuitive Error Handling: Clear feedback with Salesforce-specific error details
Related MCP server: Salesforce MCP Server
Installation
npm install -g @surajadsul02/mcp-server-salesforceSetup
Salesforce Authentication
You can authenticate with Salesforce using one of two methods:
1. Username/Password Authentication
Set up your Salesforce credentials
Get your security token (Reset from Salesforce Settings)
Configure the environment variables as shown in the configuration section
2. OAuth2 Authentication with Consumer Key/Secret
Set up a Connected App in Salesforce
Get the Consumer Key and Consumer Secret
Configure the environment variables as shown in the configuration section
IDE Integration
Cursor IDE Setup
Install the package globally:
npm install -g @surajadsul02/mcp-server-salesforceConfigure the MCP server in Cursor IDE
.cursor/mcp.json:
Using env Command
{
"mcpServers": {
"salesforce": {
"command": "env",
"args": [
"SALESFORCE_USERNAME=your.actual.email@example.com",
"SALESFORCE_PASSWORD=YourActualPassword123",
"SALESFORCE_TOKEN=YourActualSecurityToken123",
"SALESFORCE_INSTANCE_URL=https://login.salesforce.com",
"npx",
"-y",
"@surajadsul02/mcp-server-salesforce"
]
}
}
}For OAuth2 Authentication in Cursor
{
"mcpServers": {
"salesforce": {
"command": "env",
"args": [
"SALESFORCE_USERNAME=your.actual.email@example.com",
"SALESFORCE_PASSWORD=YourActualPassword123",
"SALESFORCE_TOKEN=YourActualSecurityToken123",
"SALESFORCE_INSTANCE_URL=https://login.salesforce.com",
"SALESFORCE_CONSUMER_KEY=YourConsumerKey",
"SALESFORCE_CONSUMER_SECRET=YourConsumerSecret",
"npx",
"-y",
"@surajadsul02/mcp-server-salesforce"
]
}
}
}Claude Desktop Setup
Install the package globally (if not already installed):
npm install -g @surajadsul02/mcp-server-salesforceAdd to your
claude_desktop_config.json:
For Username/Password Authentication
{
"mcpServers": {
"salesforce": {
"command": "npx",
"args": ["-y", "@surajadsul02/mcp-server-salesforce"],
"env": {
"SALESFORCE_USERNAME": "your_username",
"SALESFORCE_PASSWORD": "your_password",
"SALESFORCE_TOKEN": "your_security_token",
"SALESFORCE_INSTANCE_URL": "https://login.salesforce.com"
}
}
}
}For OAuth2 Authentication
{
"mcpServers": {
"salesforce": {
"command": "npx",
"args": ["-y", "@surajadsul02/mcp-server-salesforce"],
"env": {
"SALESFORCE_USERNAME": "your_username",
"SALESFORCE_PASSWORD": "your_password",
"SALESFORCE_CONSUMER_KEY": "your_consumer_key",
"SALESFORCE_CONSUMER_SECRET": "your_consumer_secret",
"SALESFORCE_INSTANCE_URL": "https://login.salesforce.com"
}
}
}
}Configuration File Location:
macOS:
~/Library/Application Support/Claude Desktop/claude_desktop_config.jsonWindows:
%APPDATA%\Claude Desktop\claude_desktop_config.jsonLinux:
~/.config/Claude Desktop/claude_desktop_config.json
Required Environment Variables
For Username/Password Authentication:
SALESFORCE_USERNAME: Your Salesforce username/emailSALESFORCE_PASSWORD: Your Salesforce passwordSALESFORCE_TOKEN: Your Salesforce security tokenSALESFORCE_INSTANCE_URL: Your Salesforce instance URL (Optional, default: https://login.salesforce.com)
For OAuth2 Authentication:
SALESFORCE_USERNAME: Your Salesforce username/emailSALESFORCE_PASSWORD: Your Salesforce passwordSALESFORCE_CONSUMER_KEY: Your Connected App's consumer keySALESFORCE_CONSUMER_SECRET: Your Connected App's consumer secretSALESFORCE_INSTANCE_URL: Your Salesforce instance URL (Optional, default: https://login.salesforce.com)
Example Usage
Searching Objects
"Find all objects related to Accounts"
"Show me objects that handle customer service"
"What objects are available for order management?"Getting Schema Information
"What fields are available in the Account object?"
"Show me the picklist values for Case Status"
"Describe the relationship fields in Opportunity"Querying Records
"Get all Accounts created this month"
"Show me high-priority Cases with their related Contacts"
"Find all Opportunities over $100k"Managing Custom Objects
"Create a Customer Feedback object"
"Add a Rating field to the Feedback object"
"Update sharing settings for the Service Request object"Searching Across Objects
"Search for 'cloud' in Accounts and Opportunities"
"Find mentions of 'network issue' in Cases and Knowledge Articles"
"Search for customer name across all relevant objects"Development
Building from source
# Clone the repository
git clone https://github.com/surajadsul02/mcp-server-salesforce.git
# Navigate to directory
cd mcp-server-salesforce
# Install dependencies
npm install
# Build the project
npm run buildTroubleshooting
Authentication Errors
Verify your credentials are correct
For username/password auth: ensure security token is correct
For OAuth2: verify consumer key and secret
Connection Issues
Check your Salesforce instance URL
Verify network connectivity
Ensure proper API access permissions
Cursor IDE Integration
Restart Cursor IDE after configuration changes
Check Developer Tools (Help > Toggle Developer Tools) for error messages
Verify the package is installed globally
Claude Desktop Integration
Verify configuration file location
Check file permissions
Restart Claude Desktop after configuration changes
Ensure environment variables are properly set
Contributing
Contributions are welcome! Feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Issues and Support
If you encounter any issues or need support, please file an issue on the GitHub repository.
Available Tools
8 toolssalesforce_describe_objectA
Get detailed schema metadata including all fields, relationships, and field properties of any Salesforce object. Examples: 'Account' shows all Account fields including custom fields; 'Case' shows all Case fields including relationships to Account, Contact etc.
Inputs: objectName (required).
salesforce_dml_recordsA
Perform data manipulation operations on Salesforce records:
insert: Create new records
update: Modify existing records (requires Id)
delete: Remove records (requires Id)
upsert: Insert or update based on external ID field Examples: Insert new Accounts, Update Case status, Delete old records, Upsert based on custom external ID
Inputs: operation (required), objectName (required), records (required), externalIdField.
salesforce_manage_fieldA
Create new custom fields or modify existing fields on any Salesforce object:
Field Types: Text, Number, Date, Lookup, Master-Detail, Picklist etc.
Properties: Required, Unique, External ID, Length, Scale etc.
Relationships: Create lookups and master-detail relationships Examples: Add Rating__c picklist to Account, Create Account lookup on Custom Object Note: Changes affect metadata and require proper permissions
Inputs: operation (required), objectName (required), fieldName (required), label, +13 more.
salesforce_manage_objectA
Create new custom objects or modify existing ones in Salesforce:
Create: New custom objects with fields, relationships, and settings
Update: Modify existing object settings, labels, sharing model Examples: Create Customer_Feedback__c object, Update object sharing settings Note: Changes affect metadata and require proper permissions
Inputs: operation (required), objectName (required), label, pluralLabel, +5 more.
salesforce_query_recordsA
Query records from any Salesforce object using SOQL, including relationship queries.
Examples:
Parent-to-child query (e.g., Account with Contacts):
objectName: "Account"
fields: ["Name", "(SELECT Id, FirstName, LastName FROM Contacts)"]
Child-to-parent query (e.g., Contact with Account details):
objectName: "Contact"
fields: ["FirstName", "LastName", "Account.Name", "Account.Industry"]
Multiple level query (e.g., Contact -> Account -> Owner):
objectName: "Contact"
fields: ["Name", "Account.Name", "Account.Owner.Name"]
Related object filtering:
objectName: "Contact"
fields: ["Name", "Account.Name"]
whereClause: "Account.Industry = 'Technology'"
Note: When using relationship fields:
Use dot notation for parent relationships (e.g., "Account.Name")
Use subqueries in parentheses for child relationships (e.g., "(SELECT Id FROM Contacts)")
Custom relationship fields end in "__r" (e.g., "CustomObject__r.Name")
Inputs: objectName (required), fields (required), whereClause, orderBy, +1 more.
salesforce_search_allA
Search across multiple Salesforce objects using SOSL (Salesforce Object Search Language).
Examples:
Basic search across all objects: { "searchTerm": "John", "objects": [ { "name": "Account", "fields": ["Name"], "limit": 10 }, { "name": "Contact", "fields": ["FirstName", "LastName", "Email"] } ] }
Advanced search with filters: { "searchTerm": "Cloud*", "searchIn": "NAME FIELDS", "objects": [ { "name": "Account", "fields": ["Name", "Industry"], "orderBy": "Name DESC", "where": "Industry = 'Technology'" } ], "withClauses": [ { "type": "NETWORK", "value": "ALL NETWORKS" }, { "type": "SNIPPET", "fields": ["Description"] } ] }
Notes:
Use * and ? for wildcards in search terms
Each object can have its own WHERE, ORDER BY, and LIMIT clauses
Support for WITH clauses: DATA CATEGORY, DIVISION, METADATA, NETWORK, PRICEBOOKID, SNIPPET, SECURITY_ENFORCED
"updateable" and "viewable" options control record access filtering
Inputs: searchTerm (required), objects (required), searchIn, withClauses, +2 more.
salesforce_search_objectsA
Search for Salesforce standard and custom objects by name pattern. Examples: 'Account' will find Account, AccountHistory; 'Order' will find WorkOrder, ServiceOrder__c etc.
Inputs: searchPattern (required).
salesforce_upload_report_xmlA
Upload XML to generate or update reports in Salesforce.
Examples:
Create a new report:
reportName: "Monthly Sales Summary"
folderId: "00l5e000000XXXXX" (optional - uploads to user's private reports by default)
xmlContent: "<Report xmlns=..."
isDeveloperName: false
Update existing report:
reportId: "00O5e000000XXXXX"
xmlContent: "<Report xmlns=..."
Note: XML must follow Salesforce report metadata format. For custom report types, ensure the report type exists in your org before uploading.
Inputs: xmlContent (required), reportName, reportId, folderId, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose with no overlap: describe_object for metadata, dml_records for data manipulation, manage_field/object for schema changes, query_records for SOQL queries, search_all for SOSL searches, search_objects for object discovery, and upload_report_xml for report management. The descriptions reinforce these boundaries, making tool selection unambiguous.
All tools follow a consistent snake_case pattern with a 'salesforce_' prefix and descriptive verb_noun combinations (e.g., salesforce_describe_object, salesforce_query_records). This uniformity makes the tool set predictable and easy to navigate, with no deviations in naming style.
With 8 tools, the server is well-scoped for Salesforce operations, covering key areas like data access, metadata management, and reporting. Each tool serves a specific, non-redundant function, making the count appropriate for the domain without being overwhelming or insufficient.
The tool set provides comprehensive coverage for core Salesforce workflows, including CRUD operations, schema management, querying, and reporting. A minor gap exists in lacking a dedicated tool for handling Salesforce-specific features like Apex code or flows, but agents can work around this using existing tools for most common tasks.
Maintenance
Related MCP Connectors
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
MCP server giving Claude AI access to 22+ NYC public-record databases for real estate due diligence
Related MCP Servers
- AlicenseAqualityAmaintenanceAn MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.155,358 npm165MIT
- AlicenseAqualityDmaintenanceAn MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.715MIT
- AlicenseNot gradedqualityNot gradedmaintenanceAn MCP server implementation that integrates Claude/VS Code with Salesforce, enabling natural language interactions with your Salesforce data and metadata.MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides comprehensive access to Salesforce Tooling API for metadata management, SOQL queries, code analysis, and debugging through Claude and other AI assistants.48 npm5MIT