MCP-Salesforce
MCP ServerFreeMCP Salesforce connector
Capabilities12 decomposed
soql query execution with llm-driven schema awareness
Medium confidenceExecutes Salesforce Object Query Language (SOQL) queries through an MCP tool interface, enabling LLMs to construct and run SQL-like queries against Salesforce objects. The connector caches object metadata in the SalesforceClient to reduce API calls and provide schema context to the LLM, allowing the model to understand available fields and relationships before query construction. Queries are validated and executed via the Salesforce REST API, with results returned as structured JSON for LLM processing.
Implements metadata caching within SalesforceClient to provide schema context to LLMs before query execution, reducing the number of schema discovery API calls and enabling more intelligent query construction by the model. The caching layer sits between the MCP tool handler and Salesforce REST API, allowing the LLM to understand object structures without repeated API round-trips.
Differs from direct Salesforce API clients by exposing SOQL as an MCP tool with built-in schema awareness, enabling LLMs to construct queries with field validation context rather than requiring pre-defined query templates or manual schema documentation.
sosl full-text search across salesforce objects
Medium confidenceExecutes Salesforce Object Search Language (SOSL) queries to perform full-text search across multiple Salesforce objects simultaneously. The connector routes SOSL search requests through the MCP tool handler, which formats search parameters and sends them to the Salesforce REST API. Results are returned as structured JSON containing matching records grouped by object type, enabling LLMs to discover records through natural language search terms rather than structured queries.
Exposes SOSL as an MCP tool allowing LLMs to perform full-text search across Salesforce objects without requiring knowledge of specific field names or object relationships. The search results are returned in a format optimized for LLM consumption, grouping matches by object type for easier interpretation.
Provides full-text search capability through MCP, enabling LLMs to discover records organically through keywords rather than requiring structured SOQL queries. This is more flexible than SOQL for exploratory searches but less precise for specific field-based queries.
salesforce api request formatting and response parsing
Medium confidenceFormats HTTP requests to Salesforce REST API endpoints with proper headers, authentication tokens, and request bodies, then parses JSON responses into Python objects. The SalesforceClient handles URL construction, parameter encoding, and error response interpretation. This layer abstracts away HTTP details from the MCP tool handlers, providing a clean interface for Salesforce operations.
Encapsulates Salesforce REST API request/response handling in SalesforceClient, providing a clean abstraction layer that tool handlers use without dealing with HTTP details. The client handles authentication header injection, URL construction, and JSON parsing, reducing boilerplate in tool implementations.
Provides a dedicated API abstraction layer specific to Salesforce, enabling tool handlers to focus on business logic rather than HTTP mechanics. Differs from raw HTTP clients by handling Salesforce-specific conventions like authentication headers and error response formats.
mcp server lifecycle management and request handling
Medium confidenceImplements the MCP Server component that manages the server lifecycle, including initialization, request routing, and shutdown. The server listens for MCP protocol messages from the client, routes them to appropriate handlers (list_tools, call_tool), and sends responses back. The server maintains the SalesforceClient instance and coordinates between the MCP protocol layer and Salesforce API operations.
Implements MCP Server as a dedicated component that manages the protocol layer, request routing, and lifecycle. The server maintains a SalesforceClient instance and coordinates between MCP protocol messages and Salesforce API operations, providing a clean separation of concerns.
Provides a complete MCP server implementation specific to Salesforce, handling protocol details so tool handlers can focus on business logic. Differs from raw MCP implementations by including Salesforce-specific initialization and error handling.
object metadata discovery and field schema retrieval
Medium confidenceRetrieves and caches Salesforce object metadata including field definitions, relationships, and constraints through the SalesforceClient's metadata caching layer. The MCP tool handler exposes a 'get_object_fields' tool that queries the Salesforce Describe API to return field names, types, lengths, and required/updateable flags. Metadata is cached in-memory to reduce API calls when the LLM needs to understand object structures for query construction or validation.
Implements a caching layer in SalesforceClient that stores object metadata in-memory, allowing the LLM to query field definitions without repeated API calls to Salesforce's Describe API. The cache is populated on-demand and reused across multiple tool invocations within a single server session, reducing latency and API quota consumption.
Provides schema discovery as an MCP tool with built-in caching, enabling LLMs to understand object structures efficiently. Unlike raw Salesforce API clients, the caching layer reduces round-trips and provides metadata in a format optimized for LLM consumption.
single record retrieval by id with field selection
Medium confidenceFetches individual Salesforce records by their ID through the 'get_record' MCP tool, which calls the Salesforce REST API with optional field filtering. The tool handler accepts a record ID and optional list of fields to retrieve, returning the record as a JSON object. This capability enables LLMs to fetch specific records for inspection, validation, or use in downstream operations without executing full queries.
Provides direct record retrieval by ID as an MCP tool with optional field filtering, allowing LLMs to fetch specific records efficiently without constructing SOQL queries. The tool handler validates the record ID format and field names before making the API call, reducing error rates.
Simpler and faster than SOQL queries for known record IDs, with built-in field selection to reduce payload. Enables LLMs to fetch records for validation or inspection without query construction overhead.
record creation with field validation and default handling
Medium confidenceCreates new Salesforce records through the 'create_record' MCP tool, which accepts an object type and field values as input. The tool handler sends a POST request to the Salesforce REST API with the provided field data, applying Salesforce's field validation rules and default values. The API returns the newly created record ID and any validation errors, enabling LLMs to create records with automatic constraint enforcement.
Exposes Salesforce record creation as an MCP tool with automatic field validation and constraint enforcement by the Salesforce API. The tool handler formats the request according to Salesforce REST API specifications and returns both success (record ID) and error responses in a format optimized for LLM interpretation.
Provides record creation through MCP with built-in Salesforce validation, enabling LLMs to create records safely without manual constraint checking. Differs from raw API clients by handling request formatting and error translation for LLM consumption.
record update with field-level change tracking
Medium confidenceUpdates existing Salesforce records through the 'update_record' MCP tool, which accepts a record ID and a map of field names to new values. The tool handler sends a PATCH request to the Salesforce REST API, applying only the specified field changes while preserving other field values. Salesforce's field-level validation and update permissions are enforced, and the tool returns success/failure status with any validation errors.
Implements record updates via PATCH requests to the Salesforce REST API, allowing LLMs to modify specific fields without affecting others. The tool handler validates field names against cached metadata and enforces Salesforce's field-level update permissions, providing detailed error feedback for failed updates.
Provides targeted field updates through MCP with automatic validation, enabling LLMs to make precise changes without full record replacement. More efficient than fetching, modifying, and re-saving entire records.
record deletion with id-based targeting
Medium confidenceDeletes Salesforce records through the 'delete_record' MCP tool, which accepts a record ID and sends a DELETE request to the Salesforce REST API. The tool handler validates the record ID format and enforces Salesforce's delete permissions, returning success/failure status. This capability enables LLMs to remove records as part of automated workflows or data cleanup operations.
Exposes record deletion as an MCP tool with built-in permission validation and error handling. The tool handler enforces Salesforce's delete constraints and returns detailed error messages when deletion fails due to business rules or permissions.
Provides safe record deletion through MCP with automatic permission checking, enabling LLMs to delete records while respecting Salesforce's business rules. Differs from raw API clients by providing error context optimized for LLM interpretation.
mcp tool registration and schema exposure
Medium confidenceRegisters all Salesforce operations (SOQL, SOSL, CRUD, metadata) as MCP tools with JSON schema definitions through the 'handle_list_tools' method in the MCP Server component. Each tool includes a schema describing required parameters, parameter types, and descriptions. The MCP server exposes these schemas to the LLM client, enabling the model to discover available operations and understand their signatures without hardcoding tool definitions.
Implements MCP tool registration through the handle_list_tools method, which returns a complete list of Salesforce operations with JSON schemas. The server defines tool schemas statically in the code, enabling the MCP client to discover and understand all available operations without additional configuration.
Provides standardized tool discovery through MCP, enabling LLMs to understand available Salesforce operations through a consistent protocol. Differs from custom API clients by using MCP's schema-based tool discovery, making the connector compatible with any MCP-aware LLM client.
mcp tool execution with request routing and error handling
Medium confidenceRoutes and executes MCP tool calls through the 'handle_call_tool' method, which receives tool names and arguments from the LLM client and dispatches them to the appropriate handler (SOQL, SOSL, CRUD, metadata). The method validates arguments against tool schemas, executes the operation via SalesforceClient, and returns results or error messages in MCP-compliant format. Error handling includes Salesforce API errors, validation failures, and authentication issues.
Implements tool execution through handle_call_tool, which routes requests to specific handlers based on tool name and validates arguments before execution. The method integrates with SalesforceClient to perform operations and returns results in MCP-compliant format, providing a clean separation between MCP protocol handling and Salesforce API interaction.
Provides centralized tool execution routing with error handling, enabling MCP clients to execute Salesforce operations reliably. Differs from direct API clients by handling MCP protocol details and providing consistent error reporting across all tool types.
salesforce oauth2 authentication with credential management
Medium confidenceManages Salesforce authentication through OAuth2 credentials stored in environment variables or configuration files, with the SalesforceClient establishing secure connections using these credentials. The client validates credentials during initialization and maintains an active session for API requests. Authentication errors are caught and reported, enabling the MCP server to fail gracefully if credentials are invalid or expired.
Implements OAuth2 authentication in SalesforceClient by reading credentials from environment variables and establishing authenticated sessions for all API requests. The client validates credentials during initialization, ensuring the MCP server fails fast if authentication is misconfigured.
Provides secure credential management through environment variables, avoiding hardcoded secrets in code. Enables the MCP server to authenticate with Salesforce without requiring interactive login or manual token management.
Capabilities are decomposed by AI analysis. Each maps to specific user intents and improves with match feedback.
Related Artifactssharing capabilities
Artifacts that share capabilities with MCP-Salesforce, ranked by overlap. Discovered automatically through the match graph.
@salesforce/mcp
MCP Server for interacting with Salesforce instances
@salesforce/mcp
MCP Server for interacting with Salesforce instances
@tsmztech/mcp-server-salesforce
A Salesforce connector MCP Server.
Myko
Instantly answer Salesforce queries with AI-driven real-time...
Agentforce Vibes
Extension for developing on the Salesforce Platform with the help of generative AI
Elasticsearch MCP Server
Search, index, and query Elasticsearch clusters via MCP.
Best For
- ✓Teams building AI agents that need read access to Salesforce data
- ✓Developers creating LLM-powered reporting and analytics on Salesforce records
- ✓Organizations automating data retrieval workflows through conversational interfaces
- ✓Building conversational search interfaces over Salesforce data
- ✓Enabling LLM-powered discovery of records across multiple object types
- ✓Creating AI assistants that need to find relevant Salesforce records by keyword
- ✓Building MCP servers that need to interact with Salesforce REST API
- ✓Abstracting HTTP details from tool handlers
Known Limitations
- ⚠SOQL syntax must be valid — LLM-generated queries may require validation/retry loops
- ⚠Metadata caching is in-memory only — no persistence across server restarts
- ⚠Query result size limited by Salesforce API response limits (typically 2000 records per query)
- ⚠No support for complex joins beyond Salesforce relationship queries
- ⚠SOSL searches are limited to fields marked as searchable in Salesforce
- ⚠Full-text search may return false positives requiring LLM-based filtering
Requirements
Input / Output
UnfragileRank
UnfragileRank is computed from adoption signals, documentation quality, ecosystem connectivity, match graph feedback, and freshness. No artifact can pay for a higher rank.
Repository Details
Last commit: Apr 13, 2026
About
MCP Salesforce connector
Categories
Alternatives to MCP-Salesforce
Are you the builder of MCP-Salesforce?
Claim this artifact to get a verified badge, access match analytics, see which intents users search for, and manage your listing.
Get the weekly brief
New tools, rising stars, and what's actually worth your time. No spam.
Data Sources
Looking for something else?
Search →