Salesforce Documentation MCP Server

A local-first Model Context Protocol (MCP) server for searching Salesforce Developer Documentation. Search across 360 official Salesforce PDF documents directly from VS Code, Claude Desktop, or any MCP-compatible client.

✨ Features

• 🎯 Intent-Based Search - Automatically detects query topic (Apex, REST API, LWC, etc.) and searches in relevant docs
• 📚 360 Documents - 291 developer guides + 69 release notes (Apex, LWC, REST API, Metadata API, and more)
• 🏠 100% Local - All data stays on your machine, works offline
• ⚡ Fast - Sub-second query latency with intelligent filtering + LRU caching
• 🔍 Smart Fallback - Expands search if topic-filtered results are sparse
• 📦 Packageable - Pure JavaScript (sql.js), no native dependencies
• 🔐 Secure - Parameterized queries, input validation with zod

🚀 Quick Start

Prerequisites

• Node.js 18 or higher
• npm or yarn
• VS Code with GitHub Copilot or Claude Desktop

Installation

# Clone the repository
git clone https://github.com/SalesforceDiariesBySanket/salesforce-docs-mcp.git
cd salesforce-docs-mcp

# Install dependencies
npm install

# Build the TypeScript
npm run build

# Build the search index (parses all PDFs - takes 5-10 minutes)
npm run build-index

Configure VS Code

Add to your VS Code MCP configuration (%APPDATA%\Code\User\mcp.json on Windows):

{
  "servers": {
    "salesforce-docs": {
      "type": "stdio",
      "command": "node",
      "args": ["C:\\path\\to\\salesforce-docs-mcp\\dist\\index.js"]
    }
  }
}

Configure Claude Desktop

Add to your Claude Desktop configuration (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "salesforce-docs": {
      "command": "node",
      "args": ["C:\\path\\to\\salesforce-docs-mcp\\dist\\index.js"]
    }
  }
}

🛠️ Available Tools

search_salesforce_docs

Search across all Salesforce documentation with natural language queries.

Example: "How to create an Apex trigger on Account"
Example: "REST API authentication with OAuth 2.0"
Example: "Lightning Web Component wire service"

get_api_reference

Get specific Salesforce API reference documentation.

Example: API name "REST API", endpoint "/services/data"
Example: API name "Bulk API 2.0", endpoint "jobs"

get_release_notes

Get Salesforce release notes for specific releases or features.

Example: release "Winter 26"
Example: feature "Dynamic Forms"

get_code_example

Get code examples from Salesforce documentation.

Example: topic "trigger on Account", language "apex"

list_doc_categories

List all documentation categories with document counts.

get_document

Get full content of a specific document by ID or filename.

🎯 Intent-Based Search

The MCP server automatically detects the topic of your query and searches in the most relevant documentation:

Benefits:

• 🎯 More relevant results - Searches in topic-specific docs first
• ⚡ Faster queries - Scans ~15 docs instead of 357
• 🔄 Smart fallback - Expands search if too few results found

Override: You can always specify category or subcategory to search in a specific area.

📁 Documentation Categories

🏗️ Project Structure

salesforce-docs-mcp/
├── src/
│   ├── index.ts              # MCP server entry point
│   ├── types.ts              # TypeScript type definitions
│   ├── db/
│   │   ├── database.ts       # SQLite connection (sql.js)
│   │   └── queries.ts        # Search queries with intent detection
│   └── utils/
│       ├── formatter.ts      # Result formatting
│       ├── intent.ts         # Intent detection patterns
│       ├── classifier.ts     # Document classification
│       └── chunker.ts        # PDF text chunking
├── scripts/
│   ├── build-index.ts        # PDF parsing and indexing
│   ├── test-search.ts        # Search testing (114 tests)
│   ├── test-llm-judge.ts     # LLM-as-judge evaluation
│   └── postinstall.js        # Post-install setup
├── docs/
│   ├── pdfs/                 # 291 Salesforce developer PDFs
│   └── release-notes/        # 69 release notes PDFs
├── data/
│   └── salesforce-docs.db    # SQLite search index (357 docs)
├── package.json
├── tsconfig.json
└── README.md

📥 Adding Documentation

Download Salesforce PDFs to docs/pdfs/ then rebuild the index:

npm run build-index

PDFs can be downloaded from:

https://resources.docs.salesforce.com/{version}/latest/en-us/sfdc/pdf/{name}.pdf

Current version: 258 (Winter '26, API v65.0)

🔧 Development

# Run in development mode
npm run dev

# Build TypeScript
npm run build

# Test search functionality
npm run test-search

⚡ Performance

How Intent-Based Search Improves Performance

Traditional Search:
  "Apex trigger" → Scan all 156K chunks → Filter → Rank → ~500ms

Intent-Based Search:
  "Apex trigger" → Detect: Apex (high confidence)
                 → Filter to apex subcategory (~15 docs, ~6,000 chunks)
                 → Scan → Rank → ~50ms

Note: Uses sql.js (pure JavaScript SQLite) with LIKE-based text search. Intent detection reduces search scope by 90%+ for topic-specific queries.

🔐 Security

• 100% Local: No data leaves your machine
• No API Keys: Works completely offline
• stdio Transport: No exposed HTTP endpoints
• Parameterized Queries: Protection against SQL injection
• Input Validation: All tool inputs validated with zod schemas

📜 License

MIT License - see LICENSE for details.

⚠️ Disclaimer

Salesforce Documentation: The Salesforce documentation PDF files included in this repository are the property of Salesforce, Inc. and are provided for convenience only. These documents are subject to Salesforce's own terms of use and copyright.

Trademark Notice: The trademarks and product names of Salesforce®, including the mark Salesforce®, are the property of Salesforce, Inc. This project is not affiliated with, sponsored by, or endorsed by Salesforce, Inc. The use of the Salesforce® trademark and Salesforce documentation in this project does not indicate an endorsement, recommendation, or business relationship between Salesforce, Inc. and the project maintainers.

Official Documentation: For official Salesforce documentation, please visit developer.salesforce.com/docs.

© 2026 Sanket (SalesforceDiariesBySanket) | Salesforce documentation © Salesforce, Inc.