https://github.com/salesforce-mcp/salesforce-mcp
Salesforce MCP server. Allows LLMs to interact with Salesforce data & metadata
https://github.com/salesforce-mcp/salesforce-mcp
antrophic mcp mcp-client mcp-server mcp-servers modelcontextprotocol salesforce salesforce-api salesforce-developers
Last synced: about 1 year ago
JSON representation
Salesforce MCP server. Allows LLMs to interact with Salesforce data & metadata
- Host: GitHub
- URL: https://github.com/salesforce-mcp/salesforce-mcp
- Owner: salesforce-mcp
- License: mit
- Created: 2025-04-27T12:03:40.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-05T09:26:25.000Z (about 1 year ago)
- Last Synced: 2025-05-05T09:52:55.657Z (about 1 year ago)
- Topics: antrophic, mcp, mcp-client, mcp-server, mcp-servers, modelcontextprotocol, salesforce, salesforce-api, salesforce-developers
- Language: Python
- Homepage: https://salesforce-mcp.com
- Size: 62.5 KB
- Stars: 38
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Salesforce MCP - MCP server to interact with Salesforce cloud for data and metadata operations. (Community Servers)
- metorial-index - Salesforce Connector - Interact with Salesforce data and metadata through natural language commands to gain insights, manage records, and configure the platform. Perform actions like creating, updating, and deleting Salesforce objects and fields, as well as automating tasks. (CRM and Sales Tools)
README
# Salesforce MCP Connector π
**Must read -**
**This is not an official Salesforce repository.**
Welcome to the Salesforce Model Context Protocol server!
This MCP allows you to interact with your Salesforce data and metadata using natural language.
Whether you're a business user, developer, or administrator, you can now chat with your Salesforce org to:
Get insights, Manage data, Configure the platform, create objects, fields, flows.. delete them, automate tasks and many more.
## Quick Start β‘
https://github.com/user-attachments/assets/60c8a448-c953-4399-99b3-7c3a1c976aa7
### Option 1: Cloud Version (Recommended for Most Users) βοΈ
1. Visit [salesforce-mcp.com](https://salesforce-mcp.com)
2. Click "Connect to Salesforce" and authenticate with your org
3. Start chatting with your Salesforce data right away, be aware that its not an official Salesforce product!
### Option 2: Local Version (Recommended for Developers) π»
1. Follow the configuration steps below
2. Set up your environment variables
3. Use with your preferred MCP-compatible AI assistant
## What You Can Do? β¨
## Work with your data
1. **Ask Questions About Your Data** π
- Get insights about your Salesforce records
- Example: "Show me all accounts created in the last 30 days with their names and annual revenue"
- The AI will automatically translate this into the appropriate Salesforce query
2. **Search Across Your Org** π
- Find information across all your Salesforce records
- Example: "Find all records containing 'Acme' in any field"
- Works like a powerful search engine for your Salesforce data
3. **Understand Your Data Structure** π
- Explore available fields and objects
- Example: "What fields are available on the Account object?"
- Get a clear view of your data model
4. **Manage Your Records** π
- Create, update, and delete records with natural language
- Examples:
- "Create a new Account named 'Acme Corp' with industry 'Technology'"
- "Update the phone number of Account 001xx000003DIloAAG to '555-0123'"
- "Delete the Account with ID 001xx000003DIloAAG"
- "Create a new user"...
## Work with your Metadata
5. **Create objects and fields** π οΈ
- Access and manage your Salesforce Object Manager
- Example: "Create a new custom object named "Contract with 3 fields: Name, Id and type"
- Perfect for developers and administrators
6. **Delete objects fields** π
- Interact with your custom Salesforce objects
- Example: "Delete the field type from the Contract object"
- Seamlessly integrate with your existing solutions
7. **Create custom tabs and apps** βοΈ
- Connect to any Salesforce API endpoint
- Example: "Get the describe information for the Account object"
- Unlock the full power of the Salesforce platform
8. **In Progress: Expanding Capabilities** π
- Weβre actively working on powerful new features to further streamline your Salesforce experience, including:
1. Flow automation and orchestration
2. Page Layouts
3. Validation rules
4. Reports and Dashboards
5. Simplified deployments
6. And many more...
## Configuration βοΈ
### For Local Installation
To use this connector locally, you'll need to configure it in your `claude_desktop_config.json` file. Add the following to the `mcpServers` section:
```json
{
"mcpServers": {
"salesforce": {
"command": "uvx",
"args": [
"--from",
"salesforce-mcp",
"salesforce"
],
"env": {
"USERNAME": "YOUR_SALESFORCE_USERNAME",
"PASSWORD": "YOUR_SALESFORCE_PASSWORD",
"SECURITY_TOKEN": "YOUR_SALESFORCE_SECURITY_TOKEN"
}
}
}
}
```
Replace the placeholder values with your Salesforce credentials:
- `YOUR_SALESFORCE_USERNAME`: Your Salesforce username
- `YOUR_SALESFORCE_PASSWORD`: Your Salesforce password
- `YOUR_SALESFORCE_SECURITY_TOKEN`: Your Salesforce security token
## Security Note π
Your Salesforce credentials are stored securely and are only used to establish the connection to your org. We never store or share your credentials with third parties.
## Contributing π
Thanks for being here! Whether youβre fixing a bug, adding a feature, or improving documentation β your help makes a big difference.
Hereβs how to get started:
1. Check out our [Contributing Guidelines](CONTRIBUTING.md)
2. Take a look at the open [Issues](https://github.com/salesforce-mcp/Salesforce-mcp/issues)
3. Fork the repo and create your branch
4. Open a pull request when youβre ready
We appreciate your support and look forward to collaborating! π
## Support π¬
Need help? Visit our [documentation](https://salesforce-mcp.com/docs) or contact our support team at support@salesforce-mcp.com or in our Discord channel
## License π
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.