Salesforce Files & Notes MCP. Get every document and note linked to a record instantly.
Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Salesforce Files & Notes MCP Server lets your AI agent search, manage, and retrieve documents, attachments, and notes linked to any Salesforce record using natural conversation.
Stop jumping between tabs just to find a contract version or an old case attachment. Your agent handles the whole process—finding recent files, viewing version histories, locating related proposals, and even creating follow-up notes on the spot.
What your AI agents can do
Sf create note
Creates a new text note that attaches directly to an existing Salesforce record.
Sf file details
Retrieves all metadata and version history for a specific file within the system.
Sf get attachments
Fetches legacy attachments stored directly on a record, separate from linked files.
Retrieves every document or file that is explicitly linked to the current Salesforce record.
Searches all files in your account by title, returning key details like size, type, and owner.
Creates a new structured note attached directly to the record you're viewing.
Gets the complete version history for any specific file, so you know which draft is current.
Retrieves legacy attachments that are stored on a record but might not be linked as modern files.
Lists the most recently modified files in your Salesforce environment for quick review.
Ask AI about this MCP
Supported MCP Clients
Waiting for input…
Salesforce Files & Notes: 7 Tools for Document Retrieval
Use these seven tools via your AI client to search, create, and retrieve all documents, attachments, and notes associated with Salesforce records.
019d7602sf create note
Creates a new text note that attaches directly to an existing Salesforce record.
019d7602sf file details
Retrieves all metadata and version history for a specific file within the system.
019d7602sf get attachments
Fetches legacy attachments stored directly on a record, separate from linked files.
019d7602sf linked files
Gets all modern documents and files that are explicitly connected to a specific record ID.
019d7602sf recent files
Lists the most recently modified files across your Salesforce environment.
019d7602sf search files
Searches for files by title and returns details like file type, size, and owner.
019d7602sf search notes
Searches existing notes attached to records using keywords in the note's title or body preview.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Salesforce Files & Notes, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Listen up. This isn't some fancy widget that just sits there; this is your AI agent handling every damn document and note you need in Salesforce. You won't be stuck jumping between the Files tab, the Attachments log, and the Notes section trying to remember where you saved that contract draft.
Your agent takes over the whole process—finding what you need, checking who wrote it, and even jotting down follow-up thoughts right there on the record.
When your agent is running, you've got control over every piece of context tied to a record. You can start by finding all the modern documents that are explicitly linked to whatever record you’re looking at using sf_linked_files. Need something older? Use sf_get_attachments to pull up those legacy attachments stored directly on the record, separate from the main file links.
If you don't know where a specific document is, no sweat. You can search across your entire account for files using sf_search_files, telling the agent exactly what title or keywords you’re looking for, and it'll spit out key details like the file type, who owns it, and how big it is.
If you know a file exists but need to confirm its current state, sf_file_details grabs all the metadata and shows you the full version history—you'll instantly see which draft is the one that actually matters.
For quick checks on what’s new, use sf_recent_files. This function lists every file across your environment that's been modified recently; it’s perfect for catching up fast. And if you just need a general idea of what documents are circulating lately, sf_search_files lets you search by title while also giving you the size and owner details.
When it comes to notes—the conversational stuff—your agent handles both searching and creation. If you want to know what was said about this record before, use sf_search_notes to check existing notes attached there using keywords in either the note's title or a body preview. Got something new to add? You simply tell your agent to create it; it uses sf_create_note to generate a brand-new text note that sticks right onto the record you’re viewing.
It's all about context, man. Your AI client manages finding linked documents with sf_linked_files, digging up old attachments with sf_get_attachments, and locating modern files via sf_search_files. It also lets you track the whole life cycle of a document using sf_file_details for version history, or quickly see what’s changed lately with sf_recent_files.
Plus, if you need to find background chatter on a record, use sf_search_notes, and when it's time to jump in, just tell it to write something new using sf_create_note.
How Salesforce Files & Notes MCP Works
- 1 You tell your agent exactly what you need: 'Find all proposals related to Account X.'
- 2 The agent analyzes the request and calls specific tools like
sf_linked_filesorsf_search_files, pulling data from multiple parts of Salesforce. - 3 It compiles the results—a list of files, their versions, and relevant notes—and presents it back to you in plain text format.
The bottom line is: your agent treats Salesforce like a single database, not ten separate tabs.
Who Is Salesforce Files & Notes MCP For?
Anyone who works with high-touch records—sales reps, support agents, and operations managers. If you spend more than five minutes clicking through different tabs (Files, Notes, Attachments) to get one piece of context, this is for you. You need the information now, not after a deep dive into Salesforce's UI.
Needs to instantly find the latest contract version or proposal attached to an account record before making a call.
Must pull up old case attachments and historical notes without navigating away from the active case screen.
Tracks document ownership, checks version histories, and ensures all records have required associated files or notes.
What Changes When You Connect
- Stop losing time switching tabs. Use
sf_linked_filesorsf_search_filesto pull all relevant documents (proposals, contracts) from one prompt, no matter how many records you're checking. - Audit document history without clicking. Call
sf_file_detailsto instantly see every version of a file—from the initial draft to the final signed PDF. - Find old case context fast. Use
sf_get_attachmentsandsf_search_notestogether to pull up attachments or notes that were added years ago, skipping the manual search through activity feeds. - Keep conversations organized. Call
sf_create_noteimmediately after a call. You write a note, assign it to the record, and your agent logs it instantly for follow-up. - Stay current with what's changing. Use
sf_recent_fileswhen you need a quick pulse check on what documents have been modified across accounts today.
Real-World Use Cases
The Account Handover
A new AE needs to take over an account. Instead of reading the last three months of notes and checking five different file tabs, they ask their agent: 'Get me all documents and notes for Acme Corp.' The agent calls sf_linked_files and sf_search_notes, giving them a compiled list of everything that happened.
Contract Audit
An operations manager needs to confirm the signed contract version. They run 'Find all files related to Project Alpha.' The agent uses sf_search_files and then calls sf_file_details on the result, verifying not just the name, but the specific revision number.
Quick Follow-up
You finish a customer call. Instead of switching to the Notes tab and typing manually, you prompt your agent: 'Create a note on this record that I will follow up next Tuesday regarding pricing.' The agent immediately executes sf_create_note.
Finding Old Evidence
Support needs to reference an old piece of evidence from a case opened last year. They ask the agent to check 'all attachments and notes for Case 9001.' The agent runs sf_get_attachments and sf_search_notes, bypassing modern file linking entirely.
The Tradeoffs
Searching by Memory
Trying to remember if the key context was in a 'linked file' or an old 'attachment.' You end up running multiple, separate searches and comparing results manually.
→ Don't guess. Use your agent to systematically check both: 'Check linked files AND legacy attachments for this record.' This covers all bases with one prompt.
Forgetting the Context
Finding a file named 'Proposal_Final.pdf' via sf_search_files, but having no idea which account or case it applies to.
→ Always combine searches with record context. Ask: 'Find all files for Acme Corp that are proposals.' This keeps the search scope tight.
Ignoring Versioning
Assuming the PDF you see linked is the correct, final version just because it's visible in the main record view.
→
Never trust a link at face value. Always call sf_file_details to verify the current, approved version number before sharing.
When It Fits, When It Doesn't
Use this server if your job involves cross-referencing data across multiple Salesforce tabs (Notes, Files, Attachments) and you need conversational retrieval speed. It's perfect for case management or account auditing where context is everything.
Don't use it if:
1. You are only performing a simple CRUD operation (e.g., just creating a record). Use native Salesforce tools instead.
2. Your data lives outside of Salesforce entirely (e.g., Google Drive documents). You'll need an integration for that, not this toolset.
3. You already have a single-pane-glass system built on the Vinkius platform. If your current AI setup handles all 7 tools natively, you might not need to connect it as a separate server.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Salesforce. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 7 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Finding context in Salesforce shouldn't require switching between tabs.
Right now, finding the full picture is brutal. You open the record, then click 'Files,' hoping the document you need isn't buried under five other proposals. If that fails, you have to jump to 'Attachments,' just in case it’s a legacy file from last year. Then, if none of that works, you check the Notes section for someone mentioning the contract name.
With this MCP server, you ask your agent: 'What was the final signed proposal for Acme Corp?' It runs `sf_linked_files` and checks for older items via `sf_get_attachments`. You get a compiled answer—the file path, the version number, and maybe even a note from the time it was signed. No clicking required.
Salesforce Files & Notes MCP Server: Manage files and record notes instantly.
The biggest manual step that disappears is the 'context-switching tax.' You no longer waste mental energy remembering if you checked the right tab, or whether the document was a modern link or an old attachment. The agent handles the entire data topology lookup for you.
Now, finding and correlating all documents related to a single client is one conversation. It’s not just faster; it changes how deep your workflow can go without introducing friction.
Common Questions About Salesforce Files & Notes MCP
How does sf_linked_files differ from sf_get_attachments? +
They pull different kinds of data. sf_linked_files gets modern documents that are explicitly attached to the record. sf_get_attachments retrieves older, legacy files stored on the record itself.
Can I use sf_search_notes for anything other than titles? +
No. Currently, sf_search_notes searches primarily by title and provides a body preview based on keywords in the note's content.
What if I need to create notes on multiple records at once? +
The agent executes sf_create_note one record at a time. You must specify each target record ID or contextually reference the accounts you want to update.
Does sf_file_details tell me who owns the file? +
Yes, it provides detailed metadata for the content document, including the owner and version history of that specific file instance.
When running multiple searches using sf_search_files, are there any rate limits I should be aware of? +
The connection respects standard Salesforce API rate limits. If you hit a quota, the agent receives an explicit error code and suggests a retry window. It’s best practice to batch file lookups rather than running dozens of rapid calls.
What level of permission does the connected user need for sf_get_attachments? +
The service account needs 'Read' access to both the record and the associated files. If there is a permissions issue, the tool won’t just fail; it will return a standard Salesforce security error detailing exactly which resource was blocked.
Does sf_file_details allow me to filter versions by date range? +
No, this tool retrieves every version linked to a specific ContentDocument ID. While the response includes the modification date for each file iteration, you'll need your agent logic to handle filtering that data after retrieval.
When I use sf_create_note, what format is expected for the body text? +
The tool accepts plain text only. If you send rich formatting (like Markdown or HTML), it must be stripped out before sending because Salesforce treats the input as standard readable text.
What file types are supported? +
All files stored in Salesforce CRM: PDFs, images, documents, spreadsheets — any ContentDocument or Attachment.
Can I create notes? +
Yes! Create Notes attached to any parent record (Account, Contact, Case, Opportunity).
Can I see file versions? +
Yes — view all versions of a ContentDocument with size, uploader, and modification date.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
USDA FoodData Central
Access the gold standard in nutrition data — 300,000+ foods with scientific-grade nutrient profiles from the U.S. Department of Agriculture.
Canva
Empower your AI agents to manage Canva designs, upload branding assets, and trigger automatic exports directly from your chat.
Robolytix
Monitor robotic process automation performance with analytics that track bot execution times, success rates, and exceptions.
You might also like
SERPHouse
Grant your AI agent unfiltered real-time access to Google and Bing SERP data to scrape organic search results and dynamic pricing.
Buy Me A Coffee
Manage your creator account via Buy Me A Coffee — track supporters, memberships, and digital products directly from any AI agent.
Giphy
Search, browse, and integrate the world largest library of animated GIFs and stickers into your apps and conversations.