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

• Apex Code Management: Read, create, and update Apex classes and triggers

• Intuitive Error Handling: Clear feedback with Salesforce-specific error details

• Switchable Authentication: Supports multiple orgs. Easily switch your active Salesforce org based on the default org configured in your VS Code workspace (use Salesforce_CLI authentication for this feature).

Installation

Global Installation (npm)

Claude Desktop Quick Installation

For easy setup with Claude Desktop, download the pre-configured extension:

1. Download salesforce-mcp-extension.dxt from the claude-desktop/ folder

2. Open Claude Desktop → Settings → Extensions

3. Drag the .dxt file into the Extensions window

4. Configure your Salesforce credentials when prompted

For manual Claude Desktop configuration, see Usage with Claude Desktop below.

Tools

salesforce_search_objects

Search for standard and custom objects:

• Search by partial name matches

• Finds both standard and custom objects

• Example: "Find objects related to Account" will find Account, AccountHistory, etc.

salesforce_describe_object

Get detailed object schema information:

• Field definitions and properties

• Relationship details

• Picklist values

• Example: "Show me all fields in the Account object"

salesforce_query_records

Query records with relationship support:

• Parent-to-child relationships

• Child-to-parent relationships

• Complex WHERE conditions

• Example: "Get all Accounts with their related Contacts"

• Note: For queries with GROUP BY or aggregate functions, use salesforce_aggregate_query

salesforce_aggregate_query

Execute aggregate queries with GROUP BY:

• GROUP BY single or multiple fields

• Aggregate functions: COUNT, COUNT_DISTINCT, SUM, AVG, MIN, MAX

• HAVING clauses for filtering grouped results

• Date/time grouping functions

• Example: "Count opportunities by stage" or "Find accounts with more than 10 opportunities"

salesforce_dml_records

Perform data operations:

• Insert new records

• Update existing records

• Delete records

• Upsert using external IDs

• Example: "Update status of multiple accounts"

salesforce_manage_object

Create and modify custom objects:

• Create new custom objects

• Update object properties

• Configure sharing settings

• Example: "Create a Customer Feedback object"

salesforce_manage_field

Manage object fields:

• Add new custom fields

• Modify field properties

• Create relationships

• Automatically grants Field Level Security to System Administrator by default

• Use grantAccessTo parameter to specify different profiles

• Example: "Add a Rating picklist field to Account"

salesforce_manage_field_permissions

Manage Field Level Security (Field Permissions):

• Grant or revoke read/edit access to fields for specific profiles

• View current field permissions

• Bulk update permissions for multiple profiles

• Useful for managing permissions after field creation or for existing fields

• Example: "Grant System Administrator access to Custom_Field__c on Account"

salesforce_search_all

Search across multiple objects:

• SOSL-based search

• Multiple object support

• Field snippets

• Example: "Search for 'cloud' across Accounts and Opportunities"

salesforce_read_apex

Read Apex classes:

• Get full source code of specific classes

• List classes matching name patterns

• View class metadata (API version, status, etc.)

• Support for wildcards (* and ?) in name patterns

• Example: "Show me the AccountController class" or "Find all classes matching AccountCont"

salesforce_write_apex

Create and update Apex classes:

• Create new Apex classes

• Update existing class implementations

• Specify API versions

• Example: "Create a new Apex class for handling account operations"

salesforce_read_apex_trigger

Read Apex triggers:

• Get full source code of specific triggers

• List triggers matching name patterns

• View trigger metadata (API version, object, status, etc.)

• Support for wildcards (* and ?) in name patterns

• Example: "Show me the AccountTrigger" or "Find all triggers for Contact object"

salesforce_write_apex_trigger

Create and update Apex triggers:

• Create new Apex triggers for specific objects

• Update existing trigger implementations

• Specify API versions and event operations

• Example: "Create a new trigger for the Account object" or "Update the Lead trigger"

salesforce_execute_anonymous

Execute anonymous Apex code:

• Run Apex code without creating a permanent class

• View debug logs and execution results

• Useful for data operations not directly supported by other tools

• Example: "Execute Apex code to calculate account metrics" or "Run a script to update related records"

salesforce_manage_debug_logs

Manage debug logs for Salesforce users:

• Enable debug logs for specific users

• Disable active debug log configurations

• Retrieve and view debug logs

• Configure log levels (NONE, ERROR, WARN, INFO, DEBUG, FINE, FINER, FINEST)

• Example: "Enable debug logs for user@example.com" or "Retrieve recent logs for an admin user"

Setup

Salesforce Authentication

You can connect to Salesforce using one of three authentication methods:

1. Username/Password Authentication (Default)

1. Set up your Salesforce credentials

2. Get your security token (Reset from Salesforce Settings)

2. OAuth 2.0 Client Credentials Flow

1. Create a Connected App in Salesforce

2. Enable OAuth settings and select "Client Credentials Flow"

3. Set appropriate scopes (typically "api" is sufficient)

4. Save the Client ID and Client Secret

5. Important: Note your instance URL (e.g., https://your-domain.my.salesforce.com) as it's required for authentication

3. Salesforce CLI Authentication (Recommended for local/dev) (contribution by @andrea9293)

1. Install and authenticate Salesforce CLI (sf).

2. Make sure your org is authenticated and accessible via sf org display --json in the root of your Salesforce project.

3. The server will automatically retrieve the access token and instance url using the CLI.

Usage with Claude Desktop

Add to your claude_desktop_config.json:

For Salesforce CLI Authentication:

For Username/Password Authentication:

For OAuth 2.0 Client Credentials Flow:

Note: For OAuth 2.0 Client Credentials Flow, the SALESFORCE_INSTANCE_URL must be your exact Salesforce instance URL (e.g., https://your-domain.my.salesforce.com). The token endpoint will be constructed as <instance_url>/services/oauth2/token.

Example Usage

Searching Objects

Getting Schema Information

Querying Records

Aggregate Queries

Managing Custom Objects

Examples with Field Level Security:

Managing Field Permissions

Searching Across Objects

Managing Apex Code

Managing Apex Triggers

Executing Anonymous Apex Code

Managing Debug Logs

Development

Building from source

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.