@salesforce/mcp

Establishes and manages authenticated connections to Salesforce instances through the Model Context Protocol, handling OAuth2 flows and session management. The MCP server acts as a bridge between LLM clients and Salesforce APIs, abstracting authentication complexity and maintaining connection state across multiple tool invocations without requiring clients to manage credentials directly.

Executes Salesforce Object Query Language (SOQL) queries against connected orgs and streams results back to the LLM client through MCP. The server parses SOQL syntax, validates queries against the org's schema, executes via Salesforce REST API, and formats results as structured JSON or CSV for downstream processing by the LLM.

Invokes Salesforce custom actions (Quick Actions, Custom Actions) from MCP tools with dynamic parameter mapping. The server calls Salesforce Action API, maps LLM-provided parameters to action inputs, executes the action, and returns results. Enables LLMs to trigger org-specific custom logic without hardcoding action details.

Publishes events to Salesforce Platform Events and subscribes to event streams through MCP tools. The server manages event publishing via REST API, handles event payload serialization, and optionally streams incoming events to LLM clients. Enables LLMs to trigger event-driven workflows and react to Salesforce events in real-time.

Provides atomic MCP tools for creating, retrieving, updating, and deleting Salesforce records. Each operation maps to Salesforce REST API endpoints, handles field validation, enforces org-level permissions, and returns operation results with error details. The server abstracts REST API complexity and provides consistent error handling across all CRUD operations.

Exposes Salesforce org metadata (object definitions, field types, relationships, picklist values) as queryable MCP tools. The server calls Salesforce Metadata API or Describe endpoints to fetch schema information, caches results to reduce API calls, and returns structured metadata that LLMs can use to construct valid queries and mutations without trial-and-error.

Executes bulk operations on multiple Salesforce records (create, update, delete) in a single MCP call, with granular error tracking per record. The server batches requests to Salesforce Bulk API or REST API batch endpoints, tracks success/failure for each record, and returns detailed results including which records succeeded and which failed with specific error reasons.

Fetches data from Salesforce Reports and Dashboards through MCP tools, executing reports with optional filters and returning results as structured data. The server calls Salesforce Analytics API or Report API endpoints, applies filter parameters, and formats results for LLM consumption (JSON, CSV, or summary statistics).

Triggers Salesforce workflows, approval processes, and custom actions from MCP tool calls. The server invokes Salesforce Process Builder, Flow, or Approval Process APIs with input parameters, monitors execution status, and returns results including approval decisions or workflow outcomes. Enables LLMs to initiate business processes without manual intervention.

Manages files and attachments in Salesforce through MCP tools, supporting upload, download, and metadata retrieval. The server handles file encoding/decoding, manages Salesforce ContentDocument and Attachment APIs, and tracks file relationships to records. Enables LLMs to attach documents to records or retrieve file content for processing.

Executes Salesforce global search and object-specific searches through MCP tools, returning ranked results with relevance scoring. The server calls Salesforce Search API (SOSL), applies search filters, and formats results for LLM consumption. Enables full-text search across Salesforce data without constructing SOQL queries.

Retrieves data from Salesforce list views through MCP tools, executing pre-configured filters and returning paginated results. The server calls Salesforce List View API, applies view-specific filters, and formats results for LLM consumption. Enables LLMs to access curated record sets without constructing SOQL queries.