Costco
Talks directly to Costco's internal GraphQL API to pull warehouse receipts and online orders into Claude. You get tools to list receipts by date range, fetch itemized detail by barcode, look up product names from item numbers, and check order status. The auth flow extracts OAuth2 refresh tokens from your browser's Azure AD B2C session, either semi-automatically via chrome-devtools-mcp or manually from localStorage. Multi-account support lets you separate personal and household member purchases. Useful for expense tracking, price history analysis, or building Costco spending reports without manual CSV exports.
- GitHub stars
- 1
- tools
- 7
- transport
- STDIO
- last updated
- Apr 19, 2026
Tools
7 toolsPublic tool metadata for what this MCP can expose to an agent.
list_warehouse_receiptsIn-store receipts for a date range (barcode, warehouse, total)
In-store receipts for a date range (barcode, warehouse, total)
No parameter schema in public metadata yet.
get_receipt_detailFull itemized receipt by barcode (products, quantities, prices, coupons, department codes)
Full itemized receipt by barcode (products, quantities, prices, coupons, department codes)
No parameter schema in public metadata yet.
get_all_receipt_detailsBulk fetch every receipt's full detail for a date range
Bulk fetch every receipt's full detail for a date range
No parameter schema in public metadata yet.
list_online_ordersCostco.com orders for a date range (order number, status, items, totals)
Costco.com orders for a date range (order number, status, items, totals)
No parameter schema in public metadata yet.
lookup_productsResolve item numbers to full product names + departments
Resolve item numbers to full product names + departments
No parameter schema in public metadata yet.
check_auth_statusReport token freshness and list configured accounts
Report token freshness and list configured accounts
No parameter schema in public metadata yet.
save_refresh_tokenRegister or update an account's refresh token
Register or update an account's refresh token
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
Costco MCP Server
An MCP (Model Context Protocol) server that gives Claude access to Costco warehouse receipts and online orders. Talks directly to Costco's internal GraphQL API using OAuth2 refresh tokens extracted from a browser session — no scraping, no runtime headless browser. Multi-account (e.g. personal, spouse) with per-account token storage.
Available on the MCP Registry as io.github.thehesiod/costco.
Disclaimer
Details
- Repository
- github.com/thehesiod/costco-mcp
- Category
- Data & Analytics
- Package
costco-mcp-server- Transport
- STDIO
- Registry
- MCP registry, active
More from thehesiod
Related Data & Analytics MCP servers
View all
Google Driveus-all/google-drive-mcp-serverGoogle Drive + Workspace MCP — Docs, Sheets, Slides, Shared Drives, Labels, Approvals, DWD1stars
Domain Monitorjasoncbraatz/domain-monitor-mcpQuery domain expiration data from domain-monitor.io via AI assistants like Claude.1stars
Jsc Typescript Ast Mcpjscoobyced/jsc-typescript-ast-mcpAST for TypeScript, supports creating JSON representations of React components1stars
Meelion MCPmeelion-com/meelion-mcpBrazilian fixed income & financial data for AI. Selic, CDI, IPCA, CDB/LCI/LCA rankings, FX rates.1stars
PageGuard MCPpageguard/pageguard-mcpPrivacy compliance scanning for AI coding tools. Detects tracking tech, cookies, and data gaps.1stars
RationalBloksrationalbloks/rationalbloks-mcpDeploy production REST and Neo4j Graph APIs from JSON schemas in seconds.1stars