# octoco-ltd/sheetsdata-mcp [Health: Active] **Category:** ๐Ÿ“Ÿ Embedded System **Repository:** https://github.com/octoco-ltd/sheetsdata-mcp **GitHub Stars:** 11 **npm Downloads (last month):** 217 **Views:** 2 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/octoco-ltd-sheetsdata-mcp ## Description Instant access to electronic component datasheets for AI agents โ€” specs, pinouts, package info, absolute max ratings extracted from manufacturer PDFs on demand. ## Tools Capabilities this server exposes over MCP: - **search_parts** โ€” Search for components by part number or keyword. Results merged by MPN with pricing and stock. - **search_datasheets** โ€” Semantic search across all extracted datasheets. Natural language queries like "low-noise LDO with PSRR above 70dB". - **prefetch_datasheets** โ€” Batch warm-up extraction for up to 20 parts. Fire-and-forget โ€” reduces wait times. - **check_extraction_status** โ€” Poll extraction progress after prefetch or read_datasheet. - **get_part_details** โ€” Full component details โ€” specs, parameters, pricing, and stock. - **read_datasheet** โ€” Structured datasheet sections (summary, pinout, electrical, abs_max, package) or semantic search within a datasheet. - **compare_parts** โ€” Compare 2โ€“5 parts side by side on real datasheet specs. - **check_design_fit** โ€” Validate operating conditions against datasheet limits. PASS/FAIL/WARNING per parameter. - **find_alternative** โ€” Find alternative/substitute components by specs, package, or availability. - **analyze_image** โ€” Vision AI analysis of datasheet images โ€” graphs, package drawings, pin diagrams. - **request_datasheet_upload** โ€” Request a signed URL to upload a datasheet PDF when we don't have one (`datasheet_status` = `no_source` or `unsupported`). Free โ€” fee is only charged on confirm. - **confirm_datasheet_upload** โ€” Confirm an upload: verifies SHA-256, validates PDF, checks MPN on first page, charges the upload fee, and queues extraction. Datasheets are private to your org. ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "sheetsdata-mcp": { "command": "npx", "args": ["-y","@sheetsdata/mcp"], "env": { "SHEETSDATA_API_KEY": "", "SHEETSDATA_OAUTH_CLIENT_ID": "", "SHEETSDATA_OAUTH_CLIENT_SECRET": "", "SHEETSDATA_OAUTH_REDIRECT_URI": "" } } } ``` **Requires environment variables:** `SHEETSDATA_API_KEY`, `SHEETSDATA_OAUTH_CLIENT_ID`, `SHEETSDATA_OAUTH_CLIENT_SECRET`, `SHEETSDATA_OAUTH_REDIRECT_URI` โ€” the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for). ## Documentation & README # SheetsData MCP [![MCP Badge](https://lobehub.com/badge/mcp/octoco-ltd-sheetsdata-mcp)](https://lobehub.com/mcp/octoco-ltd-sheetsdata-mcp) [![sheetsdata-mcp MCP server](https://glama.ai/mcp/servers/octoco-ltd/sheetsdata-mcp/badges/score.svg)](https://glama.ai/mcp/servers/octoco-ltd/sheetsdata-mcp) [![sheetsdata-mcp MCP server](https://glama.ai/mcp/servers/octoco-ltd/sheetsdata-mcp/badges/card.svg)](https://glama.ai/mcp/servers/octoco-ltd/sheetsdata-mcp) **Electronic component datasheets for AI agents** โ€” specs, pinouts, package data on demand. No PDFs required. [SheetsData](https://sheetsdata.com) is an MCP server that gives AI agents instant, structured access to electronic component data. One tool call returns the pinout. Another returns electrical specs. No PDFs. No uploads. No context window stuffing. > **Beta** โ€” SheetsData is currently in public beta. APIs, pricing, and features may change. See [Disclaimer](#disclaimer) below.

Sign up & connect via OAuth  ยท  API key (fallback)  ยท  Website

## Demo ``` Agent: read_datasheet("TPS54302", section="pinout") โ†’ Pin table: BOOT(6), EN(5), FB(4), GND(1), SW(2), VIN(3) Agent: check_design_fit("TPS54302", input_voltage=12, output_current=2) โ†’ PASS โ€” all parameters within datasheet limits Agent: "What's the maximum SPI clock frequency for the STM32G030?" โ†’ Uses read_datasheet to find electrical specs โ€” returns 32 MHz Agent: find_alternative("TPS54302", constraints="in_stock") โ†’ MP2315, TPS54331 ranked by package/spec match ``` The agent never sees a PDF. The engineer never uploads one. ## Tools | Tool | Description | |------|-------------| | `search_parts` | Search for components by part number or keyword. Results merged by MPN with pricing and stock. | | `search_datasheets` | Semantic search across all extracted datasheets. Natural language queries like "low-noise LDO with PSRR above 70dB". | | `prefetch_datasheets` | Batch warm-up extraction for up to 20 parts. Fire-and-forget โ€” reduces wait times. | | `check_extraction_status` | Poll extraction progress after prefetch or read_datasheet. | | `get_part_details` | Full component details โ€” specs, parameters, pricing, and stock. | | `read_datasheet` | Structured datasheet sections (summary, pinout, electrical, abs_max, package) or semantic search within a datasheet. | | `compare_parts` | Compare 2โ€“5 parts side by side on real datasheet specs. | | `check_design_fit` | Validate operating conditions against datasheet limits. PASS/FAIL/WARNING per parameter. | | `find_alternative` | Find alternative/substitute components by specs, package, or availability. | | `analyze_image` | Vision AI analysis of datasheet images โ€” graphs, package drawings, pin diagrams. | | `request_datasheet_upload` | Request a signed URL to upload a datasheet PDF when we don't have one (`datasheet_status` = `no_source` or `unsupported`). Free โ€” fee is only charged on confirm. | | `confirm_datasheet_upload` | Confirm an upload: verifies SHA-256, validates PDF, checks MPN on first page, charges the upload fee, and queues extraction. Datasheets are private to your org. | ## Prompts Built-in prompt templates that guide the agent through common hardware engineering tasks: | Prompt | Description | |--------|-------------| | `component-selection` | Walk through selecting a component: define requirements, search candidates, compare specs, validate design fit. | | `bom-review` | Review a bill of materials: look up each part, check stock and lifecycle, flag risks, suggest alternatives. | | `datasheet-deep-dive` | Deep-dive into a specific part: summarize, extract pinout, electrical specs, absolute max ratings, and application circuit. | | `design-validation` | Validate a design: check each component against operating conditions, flag out-of-spec parameters. | | `second-source` | Find second-source alternatives for a part: match package, specs, and availability across providers. | | `interface-check` | Check electrical and protocol compatibility between two ICs on a shared bus (SPI, I2C, UART). Verifies VOH/VOL vs VIH/VIL, flags level-shifter needs, extracts protocol config (SPI mode, I2C address, pull-up values). | | `firmware-kickstart` | Extract register map, init sequence, and protocol details from a peripheral IC datasheet. Generates a firmware integration guide with register writes, transaction examples, and common pitfalls. | | `thermal-review` | Thermal and derating analysis: compare operating conditions against abs max AND recommended limits, estimate junction temperature, check SOA derating curves, flag exposed-pad requirements. | ## Resources Data the server exposes for agent context: | Resource | Description | |----------|-------------| | `sheetsdata://workflow` | Recommended tool workflow for component selection โ€” search, evaluate, read datasheet, validate, compare. | | `sheetsdata://tips/datasheet-pitfalls` | The 8 most common datasheet interpretation mistakes โ€” abs max confusion, typical vs worst-case, thermal derating, voltage levels, I2C/SPI gotchas, decoupling, exposed pads, lifecycle risks. | | `sheetsdata://tips/design-review-checklist` | Hardware design review checklist covering power supply, signal interfaces, component selection, and firmware integration. | ## Authentication โ€” pick OAuth, fall back to API key SheetsData supports two auth paths. Use whichever works best for your client; both bill against the same org. | | **OAuth 2.0** | **API key** | |---|---|---| | Best for | Interactive MCP clients (Claude Desktop, Cursor, etc.) | CI, scripts, headless agents, or clients that don't speak MCP OAuth | | What you do | Click *Connect* in your client โ†’ log in here โ†’ done | Generate a key in the dashboard, paste as a `Bearer` header | | Setup | Just paste a URL | Paste a URL + a header | | Discovery | Automatic via [RFC 8414](https://datatracker.ietf.org/doc/html/rfc8414) / [RFC 9728](https://datatracker.ietf.org/doc/html/rfc9728) | n/a | | Spec compliance | PKCE-mandatory, dynamic client registration ([RFC 7591](https://datatracker.ietf.org/doc/html/rfc7591)), refresh-token rotation | RFC 6750 Bearer | | Revoke | Per-client, from `/dashboard/keys` | Delete the key | > **Recommended:** OAuth. It's a single URL paste, no copy-pasting secrets, and you can yank a connected app from the dashboard at any time. ## Quickest paths (one-click install) **Claude Desktop** โ€” download the `.mcpb` bundle from the latest [GitHub release](https://github.com/octoco-ltd/sheetsdata-mcp/releases/latest) and drag-and-drop it into the Claude Desktop window. The install dialog will surface every tool the bundle provides before confirming. Leave the API key field blank to use OAuth (recommended) โ€” Claude Desktop will open a browser tab on first use to authorize. No JSON editing. [![Download .mcpb](https://img.shields.io/badge/Download_.mcpb-Claude_Desktop-D97757?style=for-the-badge&logo=anthropic)](https://github.com/octoco-ltd/sheetsdata-mcp/releases/latest) **Cursor** or **VS Code** โ€” single-click install pre-fills the config and prompts to authorize on first use. [![Install in Cursor](https://img.shields.io/badge/Install_in_Cursor-One_click-000?style=for-the-badge&logo=cursor)](cursor://anysphere.cursor-deeplink/mcp/install?name=SheetsData&config=eyJ1cmwiOiJodHRwczovL21jcC5zaGVldHNkYXRhLmNvbS9tY3AifQ==) [![Install in VS Code](https://img.shields.io/badge/Install_in_VS_Code-One_click-007ACC?style=for-the-badge&logo=visualstudiocode)](vscode:mcp/install?%7B%22name%22%3A%22sheetsdata%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//mcp.sheetsdata.com/mcp%22%7D) For everything else, copy the snippet from the right section below. ## Install ### Claude Desktop **Easiest โ€” drag-and-drop the bundled extension.** Download the latest `sheetsdata-x.y.z.mcpb` from the [Releases page](https://github.com/octoco-ltd/sheetsdata-mcp/releases/latest) and drop the file onto the Claude Desktop window. Claude shows the list of tools the bundle provides and installs it. Leave the API key field blank to use OAuth (recommended) โ€” a browser tab opens on first use to authorize. No JSON editing, no `npm install`. **Or โ€” add a remote connector via the UI.** Open Claude Desktop โ†’ **Settings** โ†’ **Connectors** โ†’ **Add custom connector** at the bottom of the list. | Field | Value | |---|---| | Name | `SheetsData` | | URL | `https://mcp.sheetsdata.com/mcp` | Click **Add**. Claude Desktop will open a browser tab to the SheetsData consent screen โ€” pick the org to authorize, and you're done. Tools appear in Claude immediately. > **Note**: The `claude_desktop_config.json` file does **not** support the OAuth flow on Claude Desktop. The Connectors UI is the right path for OAuth โ€” only fall back to the JSON config if you want to use an API key instead.
Use an API key instead (via JSON config) Open Claude Desktop โ†’ Settings โ†’ Developer โ†’ **Edit Config**, then add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows): ```json { "mcpServers": { "sheetsdata": { "url": "https://mcp.sheetsdata.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } ``` Restart Claude Desktop. Get a key from [sheetsdata.com/dashboard/keys](https://sheetsdata.com/dashboard/keys).
### Claude Code ```bash claude mcp add sheetsdata --transport http "https://mcp.sheetsdata.com/mcp" ``` Claude Code will print a one-time OAuth URL โ€” open it, authorize, done.
Use an API key instead ```bash claude mcp add sheetsdata \ --transport http \ "https://mcp.sheetsdata.com/mcp" \ --header "Authorization: Bearer YOUR_API_KEY" ```
### Cursor Click the [**Install in Cursor**](https://github.com/octoco-ltd/sheetsdata-mcp/blob/HEAD/cursor://anysphere.cursor-deeplink/mcp/install?name=SheetsData&config=eyJ1cmwiOiJodHRwczovL21jcC5zaGVldHNkYXRhLmNvbS9tY3AifQ==) badge above, *or* add to `.cursor/mcp.json`: ```json { "mcpServers": { "sheetsdata": { "url": "https://mcp.sheetsdata.com/mcp" } } } ``` Restart Cursor โ†’ MCP panel โ†’ **SheetsData** โ†’ **Connect**.
Use an API key instead ```json { "mcpServers": { "sheetsdata": { "url": "https://mcp.sheetsdata.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } ```
### VS Code (GitHub Copilot) Click the [**Install in VS Code**](https://github.com/octoco-ltd/sheetsdata-mcp/blob/HEAD/vscode:mcp/install?%7B%22name%22%3A%22sheetsdata%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//mcp.sheetsdata.com/mcp%22%7D) badge above, *or* add to `.vscode/mcp.json`: ```json { "servers": { "sheetsdata": { "type": "http", "url": "https://mcp.sheetsdata.com/mcp" } } } ``` VS Code will prompt you to authorize on first use.
Use an API key instead ```json { "servers": { "sheetsdata": { "type": "http", "url": "https://mcp.sheetsdata.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } ```
### Windsurf Add to `~/.codeium/windsurf/mcp_config.json`: ```json { "mcpServers": { "sheetsdata": { "url": "https://mcp.sheetsdata.com/mcp" } } } ``` Restart Windsurf and click Connect on the SheetsData entry.
Use an API key instead ```json { "mcpServers": { "sheetsdata": { "url": "https://mcp.sheetsdata.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } ```
### Amp (Sourcegraph) Add to your Amp settings: ```json { "amp.mcpServers": { "sheetsdata": { "url": "https://mcp.sheetsdata.com/mcp" } } } ``` Amp will run the OAuth flow on first use.
Use an API key instead ```json { "amp.mcpServers": { "sheetsdata": { "url": "https://mcp.sheetsdata.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } ```
### Cline > Cline doesn't yet support the MCP OAuth flow โ€” use an API key. In VS Code, open Cline โ†’ gear icon โ†’ **MCP Servers**: ```json { "mcpServers": { "sheetsdata": { "url": "https://mcp.sheetsdata.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" }, "disabled": false } } } ``` ### Zed > Zed doesn't yet support the MCP OAuth flow โ€” use an API key. Add to Zed `settings.json`: ```json { "context_servers": { "sheetsdata": { "settings": { "url": "https://mcp.sheetsdata.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } } ``` ### Continue.dev > Continue doesn't yet support the MCP OAuth flow โ€” use an API key. Add to `~/.continue/config.yaml`: ```yaml mcpServers: - name: sheetsdata url: https://mcp.sheetsdata.com/mcp headers: Authorization: "Bearer YOUR_API_KEY" ``` ### npx (stdio proxy for any client) For clients that only support stdio transport: ```bash SHEETSDATA_API_KEY=your_key npx @sheetsdata/mcp ``` ## Need an API key? 1. Sign up at [sheetsdata.com/signup](https://sheetsdata.com/signup) (30 seconds, free credits) 2. Go to [Dashboard โ†’ API Keys](https://sheetsdata.com/dashboard/keys) 3. Click **Create key**, copy the token, paste it into your config You can also manage OAuth-authorized apps from the same page โ€” see who has connected, when, and revoke any of them with one click. ## Recommended Workflow ``` 1. search_parts โ†’ Find candidates by keyword or part number 2. get_part_details โ†’ Evaluate pricing, stock, parameters 3. read_datasheet โ†’ Get detailed specs (pinout, electrical, package) 4. check_design_fit โ†’ Validate against your operating conditions 5. find_alternative โ†’ Find substitutes if needed 6. compare_parts โ†’ Side-by-side comparison of finalists ``` ## Support - Email: [support@octoco.ltd](mailto:support@octoco.ltd) - Issues: [github.com/octoco-ltd/sheetsdata-mcp/issues](https://github.com/octoco-ltd/sheetsdata-mcp/issues) - Website: [sheetsdata.com](https://sheetsdata.com) ## Disclaimer SheetsData is currently in **public beta**. Data is extracted from publicly available manufacturer datasheets using 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 the 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 are subject to change during the beta period For terms of use, see [sheetsdata.com/terms](https://sheetsdata.com/terms). ## License MIT