Integrations
Allows executing SOQL queries against Salesforce data, retrieving and processing Salesforce records, and interacting with Salesforce orgs using authenticated connections.
Salesforce MCP Integration
This project provides a Model Context Protocol (MCP) server for Salesforce integration, allowing you to execute SOQL queries and interact with Salesforce data through a standardized interface.
Features
- Connect to Salesforce orgs using environment variables
- Execute SOQL queries against Salesforce data
- Retrieve and process Salesforce records
- Secure credential management using environment variables
Prerequisites
- Node.js (v14 or higher)
- npm (Node Package Manager)
- Salesforce org with API access
- Salesforce credentials (username, password, and security token)
Installation
- Clone this repository:Copy
- Install dependencies:Copy
- Create a
.env
file in the root directory with your Salesforce credentials:Note: For sandbox environments, useCopyhttps://test.salesforce.com/
as the login URL.
Usage
Starting the MCP Server
Run the server using Node.js:
The server will connect to Salesforce using the credentials in your .env
file and start listening for MCP requests.
Executing SOQL Queries
Once the server is running, you can execute SOQL queries through the MCP interface. The server provides a soqlQuery
tool that accepts SOQL queries and returns the results.
Example SOQL query:
Project Structure
server.js
- Main MCP server implementation.env
- Environment variables for Salesforce credentialspackage.json
- Project dependencies and scripts
Security Considerations
- Never commit your
.env
file to version control - Add
.env
to your.gitignore
file - Use environment variables for all sensitive information
- Consider using a more secure authentication method for production environments
Troubleshooting
Connection Issues
If you encounter connection issues:
- Verify your Salesforce credentials in the
.env
file - Check that your Salesforce org is accessible
- Ensure your IP address is whitelisted in Salesforce (if required)
- Verify that your Salesforce user has API access
Query Errors
If your SOQL queries fail:
- Check the SOQL syntax
- Verify that the objects and fields exist in your org
- Ensure your user has permission to access the objects and fields
License
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that allows execution of SOQL queries and interaction with Salesforce data through a standardized interface.
Related MCP Servers
- AsecurityFlicenseAqualityA Model Context Protocol server implementation for interacting with Salesforce through its REST API.Last updated -410TypeScript
- -securityFlicense-qualityA Model Context Protocol server that enables SQL query execution, database management, and business intelligence capabilities through MySQL connections.Last updated -JavaScript
- -security-license-qualityA Model Context Protocol server that provides tools for connecting to and interacting with various database systems (SQLite, PostgreSQL, MySQL/MariaDB, SQL Server) through a unified interface.Last updated -Python
- -securityAlicense-qualityA Model Context Protocol server that enables executing SQL queries and managing connections with Microsoft SQL Server databases.Last updated -3TypeScriptMIT License