Skip to content
littleworksdocs

Explore the documentation

Meet LittleworksA small backend your agent can use for Shopify tasks.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 using Littleworks for Shopify tasks.Write a workA JavaScript handler, a small manifest, and an immutable version each time you deploy.Store dataDocument collections with a small API, scoped automatically to the work that uses them.Call ShopifyUse Shopify’s GraphQL API directly, with credentials held by Littleworks.Expose an endpointConnect an existing frontend to a work through a small JSON API.MCP tool referenceTen tools to inspect, deploy, run, and manage the backend for a connected store.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.