Skip to content
littleworksdocs

Explore the documentation

Meet LittleworksA little backend for what you’re building on Shopify.Littleworks or your own appWhat it takes to give a Shopify feature a backend: with Littleworks, or with a custom app you build and run yourself.Connect to LittleworksChoose the CLI, a plugin, or a remote MCP connection.CLIConnect from your terminal with Shopify approval and no manual tokens.Claude pluginThe Littleworks MCP connection and agent guidance in one package.OpenAI pluginThe Littleworks MCP connection and agent guidance in one package.MCP with OAuthConnect a compatible client directly, without a marketplace plugin.Build with an agentThe operating guide for agents building on Shopify with Littleworks.Write a workA JavaScript handler, a small manifest, and a version you test and then publish.Keep secretsEncrypted credentials, shared across your store’s works.Call external servicesMake public HTTPS API requests from a work using http.fetch().Store dataDocument collections with a small API, scoped automatically to the work that uses them.Call ShopifyCall Shopify’s Admin and Storefront GraphQL APIs with credentials held by Littleworks.Store filesKeep uploads such as artwork and photos in the merchant’s Shopify Files, uploaded by the browser straight to Shopify.Expose an endpointConnect an existing frontend to a work through a small JSON API.Customer access and invitationsRequire a signed-in shopper or a narrow, expiring invitation before a work runs.RecipesUseful things to build for your store, with the backend already taken care of.Product reviewsCollect customer reviews, verify purchases, and publish approved content directly into your Shopify theme.Customer wishlistsGive signed-in customers a persistent list of products they can revisit across devices.Customer quote requestsCollect a customer’s products, quantities, and requirements without turning a request into an order.Back-in-stock alertsCollect confirmed signups on sold-out variants, email them through your own provider when stock returns, and see every signup and send in your admin.Transactional emailSend email from your works through your own provider, never twice for the same thing, and see what was sent and what failed.Build a merchant pageDescribe your records and what merchants do with them; Littleworks renders a native Shopify admin page.Run works on their ownRun a work when something happens in the store, on a schedule, or from a Shopify Flow workflow.Run background jobsQueue runs for later or in the background: fan out to thousands of customers, import in pages, follow up days later, and retry what fails.MCP tool referenceTools to inspect, deploy, run, and organize the backend for a connected store.Usage and allowancesSee what your works use, how much capacity remains, and when allowances reset.Inspect and troubleshootFind the relevant run, understand the failure, and make the next change deliberately.Limits and securityThe current runtime boundaries, data isolation model, and execution allowances.
Shopify admin
Browse documentation
Connect
Markdown

MCP with OAuth

Connect a compatible client directly, without a marketplace plugin.

Connection details

Server URL
https://littleworks.app/mcp
SettingValue
TransportStreamable HTTP
AuthenticationOAuth authorization code with S256 PKCE
Suggested namelittleworks
Client registrationAutomatic / dynamic
Scopestore:manage
StoreSelected during OAuth approval

Use your client’s OAuth flow. No API key or client secret is needed. After authorization starts, enter your store’s myshopify.com domain, sign in to Shopify, and approve the connection. The address is shared; your token limits access to the approved store.

Claude

Open Claude connectors, add a custom connector named Littleworks, and paste the server URL. Keep automatic registration and the detected OAuth settings, then connect and approve in Shopify. Enable Littleworks for your conversation if needed. See Claude’s current availability and instructions.

Codex

Add and authorize
codex mcp add littleworks --url https://littleworks.app/mcp
codex mcp login littleworks

Check existing connections first and preserve them. These commands configure local Codex; they do not install a ChatGPT web plugin. Start a new session if your client requires it.

ChatGPT

Where your account and workspace permit custom MCP connections, enable developer mode and add the remote server using OAuth. This setup is separate from local Codex configuration. See OpenAI’s developer-mode instructions for current eligibility and controls.

Cursor

Add Littleworks to Cursor, confirm the installation, then complete OAuth. Alternatively, add the URL in Cursor’s MCP settings. See Cursor’s connection documentation.

Other MCP clients

Add the same URL as a remote Streamable HTTP server and use OAuth. Discovery starts at /.well-known/oauth-protected-resource/mcp; authorization metadata is at /.well-known/oauth-authorization-server. Clients must support dynamic registration, S256 PKCE, and resource-bound tokens. URL-based client metadata documents are not currently supported.

Connection lifecycle

Access tokens last one hour. Refresh tokens rotate, and grants expire after 90 days. Let your client manage them. Disconnecting from Littleworks invalidates the connection immediately. Existing store-specific connections remain supported; use the shared URL for new connections.