SheetsData MCP
[npm] [MCP Badge] [sheetsdata-mcp MCP server]
[sheetsdata-mcp MCP server]
Electronic component datasheets for AI agents — pinouts, specs, package info and design checks from manufacturer PDFs.
SheetsData is a hosted MCP server. Your agent finds parts across JLCPCB, Mouser and DigiKey, reads any section of a part's datasheet as text and tables, compares parts, checks a BOM, and checks your operating conditions against the datasheet's ratings. The agent never sees a PDF, and you don't have to find or paste one.
This repository holds the install configs, the @sheetsdata/mcp stdio proxy for clients that only start local servers, and the Claude Desktop bundle. The server itself is a hosted service.
Create a free account ·
Install in your client ·
Pricing ·
Docs
What it looks like
"Is the TPS54302 fine with 24 V in and 2.5 A out?"
A condition the tool can't find a limit for is listed as unmatched and keeps the verdict at WARNING: a clean PASS means every condition was checked against the datasheet.
"Buck converters that take 24 V in and give at least 2 A" (free):
Tools
Prices are per call and the same on every plan. A call that fails is not charged. Current prices are on sheetsdata.com/pricing.
Pass manufacturer part numbers (TPS54302, STM32F446RCT6) or LCSC numbers (C2837938), not values like 100nF or reference designators like R1. A datasheet nobody has asked for yet is read on first request (poll check_extraction_status); after that it is cached for everyone.
Prompts
Built-in prompts that walk the agent through common hardware tasks:
Resources
Pricing
- Free to start. A new account gets $5 of credit, no card needed ($20 more when you add a card). Searching (
search_parts, find_parts) is free.
- Trial is pay as you go from a prepaid balance: 5 new datasheets a day (datasheets already read are unlimited), 30 requests a minute.
- Pro is $39 a month minimum, with your calls counting toward it: no daily cap on new datasheets, higher rate limits and a private parts library.
Plans, limits and fees: sheetsdata.com/pricing.
Authentication
Use whichever your client supports; both bill the same organisation.
If a client asks how to register an OAuth client, choose automatic (dynamic) registration; SheetsData doesn't support client ID metadata documents yet.
Install
One-click installs (sign in on first use):
[Install in Cursor]
[Install in VS Code]
[Install in VS Code Insiders]
[Install in Kiro]
[Download .mcpb for Claude Desktop]
Every client below was checked against its own documentation on 2026-10-16 (linked in each section). In the snippets, replace YOUR_API_KEY with a key from sheetsdata.com/dashboard/keys.
Claude (claude.ai and Claude Desktop)
Custom connector (OAuth). Open Customize → Connectors, click + Add, then Add custom connector. Name it SheetsData, paste https://mcp.sheetsdata.com/mcp and click Continue. Under OAuth client, choose Register automatically: SheetsData doesn't support the default "Use Claude's published identity" option yet. Click Add, then Connect, and sign in to SheetsData in the browser tab that opens. On Team and Enterprise plans an owner adds it under Organization settings → Connectors → Add → Custom → Web. Free plans can add one custom connector.
Claude Desktop bundle. Download sheetsdata-x.y.z.mcpb from the latest release and drop it onto the Claude Desktop window. Leave the API key field blank to sign in with OAuth, or paste a key.
Use an API key instead
In the custom connector dialog, add the request header Authorization: Bearer YOUR_API_KEY. Or, in Claude Desktop, open Settings → Developer → Edit Config and add the stdio proxy (needs Node.js 20.18.1 or later; claude_desktop_config.json only starts local servers, so it cannot hold the remote URL):
Restart Claude. The proxy sends the key in a header, never on the command line.
Docs: Custom connectors using remote MCP
Claude Code
Start Claude Code, run /mcp, choose sheetsdata → Authenticate and sign in (or run claude mcp login sheetsdata from your shell). Add --scope user to have SheetsData in every project.
Use an API key instead
In a project's .mcp.json, give the entry "type": "http"; an entry without a type is treated as a local server.
Docs: Claude Code MCP
ChatGPT
On the web, open chatgpt.com/plugins, click +, then Add custom MCP server. Name it SheetsData, paste https://mcp.sheetsdata.com/mcp and choose OAuth. Accept the warning, choose Create as a plugin, install it and sign in to SheetsData. Your plan and workspace settings decide whether custom servers are available. ChatGPT cannot send an API key.
Docs: Custom MCP servers in ChatGPT
OpenAI Codex
The second command opens your browser to sign in. The Codex IDE extension and app read the same ~/.codex/config.toml.
Use an API key instead
Add to ~/.codex/config.toml, and set SHEETSDATA_API_KEY in your shell:
Docs: Codex MCP
Cursor
Click Install in Cursor, or add to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project):
Cursor opens your browser to sign in when it first connects.
Use an API key instead
Docs: Cursor MCP
VS Code (GitHub Copilot)
Click Install in VS Code, run code --add-mcp '{"name":"sheetsdata","type":"http","url":"https://mcp.sheetsdata.com/mcp"}', or add to .vscode/mcp.json (run MCP: Open User Configuration for every workspace):
Start the server; VS Code asks you to sign in. Use it from Copilot Chat in agent mode.
Use an API key instead
VS Code asks for the key the first time the server starts and keeps it out of the file:
Docs: VS Code MCP configuration
GitHub Copilot CLI
Or run /mcp add in a session, choose HTTP and paste the URL. Copilot CLI signs in with OAuth when the server asks.
Use an API key instead
Docs: Adding MCP servers to Copilot CLI
Gemini CLI
Start Gemini CLI, run /mcp auth sheetsdata and sign in.
Use an API key instead
Editing ~/.gemini/settings.json by hand? Use "httpUrl" for the address; "url" means the older SSE transport.
Docs: Gemini CLI MCP servers
Google Antigravity
Open the … menu → MCP Servers → Manage MCP Servers → View raw config (~/.gemini/config/mcp_config.json, or .agents/mcp_config.json in a workspace) and add:
Antigravity needs serverUrl; it rejects url. Then open Agent settings → Customizations and click Authenticate next to sheetsdata. For an API key, add "headers": { "Authorization": "Bearer YOUR_API_KEY" } to the entry.
Docs: Antigravity MCP
Windsurf (Devin Desktop)
In the Cascade panel, open the … menu → MCPs → Open MCP config file (~/.config/devin/mcp_config.json; %APPDATA%\devin\mcp_config.json on Windows; older Windsurf versions use ~/.codeium/windsurf/mcp_config.json) and add:
You sign in to SheetsData in your browser when it connects. For an API key, add "headers": { "Authorization": "Bearer YOUR_API_KEY" } to the entry.
Docs: Cascade MCP
Zed
Add to your Zed settings.json (or Settings → AI → MCP Servers → Add Server → Add Remote Server):
Zed asks you to sign in. For an API key, add "headers": { "Authorization": "Bearer YOUR_API_KEY" } to the entry.
Docs: Zed MCP
Cline
Open MCP Servers → Remote Servers, name it SheetsData, paste https://mcp.sheetsdata.com/mcp, choose Streamable HTTP and click Add Server; complete the browser sign-in when prompted. In Cline CLI, run cline mcp and choose Authorize OAuth for sheetsdata.
Use an API key instead
Open MCP Servers → Configure → Configure MCP Servers (cline_mcp_settings.json) and add the entry below. Without "type", Cline assumes SSE.
Or from Cline CLI: cline mcp add sheetsdata https://mcp.sheetsdata.com/mcp --transport http --header "Authorization: Bearer YOUR_API_KEY" --yes
Docs: Cline MCP
Roo Code
Roo Code's docs don't describe MCP OAuth, so use an API key. Open MCP → Edit Global MCP (mcp_settings.json) or the project's .roo/mcp.json:
Docs: Using MCP in Roo Code
Continue
Continue's docs don't describe MCP OAuth, so use an API key. Save as .continue/mcpServers/sheetsdata.yaml in your workspace and add SHEETSDATA_API_KEY to your Continue secrets:
Docs: Continue MCP
Goose
In Goose Desktop, open Extensions → Add custom extension and choose Streamable HTTP with the URL https://mcp.sheetsdata.com/mcp; in the CLI, run goose configure → Add Extension → Remote Extension (Streamable HTTP). Goose runs the OAuth sign-in when it connects. Or add to ~/.config/goose/config.yaml:
For an API key, add headers: { Authorization: "Bearer YOUR_API_KEY" } to the entry.
Docs: Using extensions in Goose
Amp
Amp opens your browser to sign in.
Use an API key instead
Add to ~/.config/amp/settings.json (or .amp/settings.json in a project, then run amp mcp approve sheetsdata):
Docs: Amp MCP
Kiro
Click Install in Kiro, or add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in a workspace):
Kiro asks you to sign in. For an API key, add "headers": { "Authorization": "Bearer YOUR_API_KEY" } to the entry.
Docs: Kiro MCP configuration
JetBrains (Junie and AI Assistant)
Junie (IDE and CLI): add to ~/.junie/mcp/mcp.json (or .junie/mcp/mcp.json in a project), then run /mcp and choose Authorize. For an API key, add "headers": { "Authorization": "Bearer YOUR_API_KEY" }.
AI Assistant: its docs describe neither OAuth nor headers for remote servers, so run the local proxy. Open Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add and paste the stdio entry below.
Docs: Junie MCP, AI Assistant MCP
opencode
Add to opencode.json:
opencode signs in automatically, or run opencode mcp auth sheetsdata. For an API key, add "headers": { "Authorization": "Bearer YOUR_API_KEY" } to the entry.
Docs: opencode MCP servers
LM Studio
LM Studio's docs don't describe MCP OAuth, so use an API key. Open the Program tab → Install → Edit mcp.json:
Docs: LM Studio MCP
Warp
Open Settings → Agents → MCP servers → + Add and paste:
Warp opens your browser to sign in when the server starts. For an API key, add "headers": { "Authorization": "Bearer YOUR_API_KEY" } to the entry.
Docs: Warp MCP
Any client that only starts local servers
The @sheetsdata/mcp package (Node.js 20.18.1 or later) proxies stdio to the hosted server. Without SHEETSDATA_API_KEY it opens your browser to sign in with OAuth and caches the token.
From a shell: SHEETSDATA_API_KEY=YOUR_API_KEY npx -y @sheetsdata/mcp, or npx -y @sheetsdata/mcp --api-key YOUR_API_KEY.
Your own code
Connect with the MCP TypeScript SDK over Streamable HTTP (the SDK can also run the OAuth flow):
Recommended workflow
Support
Disclaimer
Data is extracted from publicly available manufacturer datasheets by automated tools, including AI. It may contain errors, omissions or inaccuracies.
SheetsData and Octoco Ltd provide this data on an "as is" basis and make no warranties, express or implied, regarding its accuracy, completeness or fitness for any particular purpose. Always verify critical specifications against the official manufacturer datasheet before making design, purchasing or manufacturing decisions.
By using this service, you acknowledge that:
- Extracted data may differ from the original manufacturer datasheet
- SheetsData is not a substitute for reviewing official documentation
- Octoco Ltd is not liable for any damages, losses, or design failures arising from the use of this data
- Features, APIs and pricing may change
For terms of use, see sheetsdata.com/terms.
License
MIT (this repository: install configs, the npm proxy and the Claude Desktop bundle). The hosted service is covered by the terms of use.