# Order Desk

```json
{
  "name": "Order Desk",
  "slug": "order_desk",
  "url": "https://composio.dev/toolkits/order_desk",
  "markdown_url": "https://composio.dev/toolkits/order_desk.md",
  "logo_url": "https://logos.composio.dev/api/order_desk",
  "categories": [
    "e-commerce"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-08-20T15:33:30.579Z"
}
```

![Order Desk logo](https://logos.composio.dev/api/order_desk)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Order Desk MCP or direct API to review orders, update shipments, check inventory, and query store data through natural language.

## Summary

Order Desk is an order management platform for ecommerce orders, shipments, inventory, and store data.
It helps teams centralize fulfillment workflows across multiple ecommerce integrations.

## Categories

- e-commerce

## Toolkit Details

- Tools: 20

## Images

- Logo: https://logos.composio.dev/api/order_desk

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for Order Desk.
  - Setup:
    - Configure Api Key credentials for Order Desk.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- List orders awaiting shipment today
- Find orders missing tracking numbers
- Update inventory for low-stock products

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `ORDER_DESK_ADD_ORDER_HISTORY_NOTE` | Add Order History Note | Append a timestamped note permanently to an existing order's history. Order history is append-only, so this tool cannot edit or remove the entry. |
| `ORDER_DESK_ADD_ORDER_ITEM` | Add Order Item | Add one line item to an existing order. |
| `ORDER_DESK_ADD_ORDER_ITEMS` | Add Order Items | Add two to 10 line items sequentially to the same order and return a result for every processed item. This batch is not atomic. |
| `ORDER_DESK_CREATE_INVENTORY_ITEM` | Create Inventory Item | Create one inventory item with a unique SKU and return its positive Order Desk ID and complete created representation. |
| `ORDER_DESK_CREATE_INVENTORY_ITEMS` | Create Inventory Items | Create two to 10 inventory items sequentially and return each created ID or error. This batch is not atomic. |
| `ORDER_DESK_CREATE_SHIPMENTS` | Create Shipments | Create one or more shipment records across orders in one request and report the success or error returned for every shipment. |
| `ORDER_DESK_DELETE_INVENTORY_ITEM` | Delete Inventory Item | Permanently delete one inventory item by its positive Order Desk ID. This destructive action cannot be undone; verify the ID before calling it. |
| `ORDER_DESK_DELETE_ORDER_ITEM` | Delete Order Item | Permanently remove one line item from an order. This destructive action cannot be undone by this tool; verify both IDs before calling it. |
| `ORDER_DESK_DELETE_SHIPMENT` | Delete Shipment | Permanently remove one shipment record from an order. This destructive action cannot be undone by this tool; verify both IDs before calling it. |
| `ORDER_DESK_GET_INVENTORY_ITEM` | Get Inventory Item | Get one inventory item by its positive Order Desk ID. |
| `ORDER_DESK_GET_ORDER` | Get Order | Get one order and its addresses, line items, shipments, metadata, notes, and discounts by Order Desk internal ID. |
| `ORDER_DESK_GET_STORE_METADATA` | Get Store Metadata | Return safe store identity, locale, timezone, page-size settings, and folder IDs and names without exposing credentials or email configuration. |
| `ORDER_DESK_LIST_INVENTORY_ITEMS` | List Inventory Items | Search inventory items in the connected store by ID, SKU, name, metadata, manufacturer SKU, location, or update time. |
| `ORDER_DESK_LIST_ORDER_ITEMS` | List Order Items | Return all line items for one order. |
| `ORDER_DESK_LIST_ORDERS` | List Orders | Find orders in the connected store using at least one narrowing filter and return one bounded page. Use next_cursor to continue the same query. |
| `ORDER_DESK_LIST_ORDER_SHIPMENTS` | List Order Shipments | Return all shipments recorded for one order. |
| `ORDER_DESK_MOVE_ORDERS` | Move Orders | Move one or more orders to exactly one destination folder selected by positive ID or exact name, with a result for every order. |
| `ORDER_DESK_UPDATE_INVENTORY_ITEMS` | Update Inventory Items | Safely update selected fields on one or more inventory items while preserving every omitted field. |
| `ORDER_DESK_UPDATE_ORDER_ITEM` | Update Order Item | Safely update selected fields on one order line item while preserving every omitted field. |
| `ORDER_DESK_UPDATE_SHIPMENT` | Update Shipment | Safely update selected fields on one shipment while preserving every omitted field. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Order Desk Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Order Desk actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'List recent Order Desk orders awaiting shipment'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List recent Order Desk orders awaiting shipment'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK for Python or TypeScript
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Initialize Client and Create Tool Router Session

Import and initialize the Composio client, then create a Tool Router session for Order Desk
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent (Anthropic Claude or Mastra)
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Order Desk tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Find Order Desk orders missing tracking numbers')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Find Order Desk orders missing tracking numbers'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Order Desk Integration

- Supports both Order Desk MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable order, shipment, and inventory actions
- Rich coverage for reading, writing, and querying your Order Desk store data

### 2. Managed Auth

- Use auth_configs.create() to configure Order Desk API key authentication once
- Use connected_accounts.link() to connect each store or user without hard-coding keys
- Composio handles secure credential storage and API request handling for your agents

### 3. Agent Optimized Design

- Tools are tuned for real ecommerce tasks like finding delayed orders or checking shipment status
- Clean execution logs show which Order Desk action ran, when it ran, and on whose behalf
- Your agent gets predictable tool schemas instead of brittle custom integration code

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Order Desk
- Scoped, least privilege access to Order Desk orders, shipments, inventory, and store data
- Full audit trail of agent actions to support review, fulfillment checks, and compliance

## Use Order Desk with any AI Agent Framework

Choose a framework you want to connect Order Desk with:

None listed.

## Related Toolkits

- [Addresszen](https://composio.dev/toolkits/addresszen) - Addresszen is a real-time address autocomplete and verification service. It helps capture accurate, deliverable addresses with instant suggestions and validation.
- [Asin data api](https://composio.dev/toolkits/asin_data_api) - Asin data api gives you detailed, real-time product data from Amazon, including price, rank, and reviews. Perfect for e-commerce pros and data-driven marketers who need instant marketplace insights.
- [Baselinker](https://composio.dev/toolkits/baselinker) - BaseLinker is an all-in-one e-commerce management platform connecting stores, marketplaces, carriers, and more. It streamlines order processing, inventory control, and automates your sales operations.
- [Bestbuy](https://composio.dev/toolkits/bestbuy) - Best Buy is a leading retailer offering APIs for product, store, and recommendation data. Instantly access up-to-date retail insights for smarter shopping and decision-making.
- [Bluebarry](https://composio.dev/toolkits/bluebarry) - Bluebarry is a customer data and product-advice platform for shopper identities, profiles, and recommendations. It helps teams analyze customer context and synchronize shopper data for better commerce experiences.
- [Btcpay server](https://composio.dev/toolkits/btcpay_server) - BTCPay Server is a free, open-source, self-hosted Bitcoin payment processor. It lets merchants accept Bitcoin payments directly, cutting out middlemen and boosting privacy.
- [Cdr platform](https://composio.dev/toolkits/cdr_platform) - Cdr platform is an API for purchasing carbon dioxide removal services. It enables businesses to offset emissions by accessing verified carbon removal projects.
- [Cloudcart](https://composio.dev/toolkits/cloudcart) - CloudCart is an e-commerce platform for building and managing online stores. It helps businesses streamline product listings, orders, and customer engagement.
- [Countdown api](https://composio.dev/toolkits/countdown_api) - Countdown API gives you real-time, structured eBay product data, reviews, and seller feedback. Perfect for powering price monitoring, product research, or marketplace analytics workflows.
- [Dpd2](https://composio.dev/toolkits/dpd2) - Dpd2 is a robust email management platform for handling, sorting, and automating email workflows. Streamline your communications and boost productivity with advanced sorting, labeling, and response tools.
- [Finerworks](https://composio.dev/toolkits/finerworks) - FinerWorks is an online platform for fine art and photo printing services. Artists and photographers use it to order custom prints and manage print inventory efficiently.
- [Fingertip](https://composio.dev/toolkits/fingertip) - Fingertip is a business management platform for selling, booking, and customer engagement—all from a single link. It helps businesses streamline operations and connect with customers across social channels.
- [Fraudlabs pro](https://composio.dev/toolkits/fraudlabs_pro) - FraudLabs Pro is an online payment fraud detection service for e-commerce and merchants. It helps minimize chargebacks and revenue loss by detecting and preventing fraudulent transactions.
- [Gift up](https://composio.dev/toolkits/gift_up) - Gift Up! is a digital platform for selling, managing, and redeeming gift cards online. It streamlines promotions and gift card transactions for businesses and their customers.
- [Goody](https://composio.dev/toolkits/goody) - Goody is a gifting platform that lets users send gifts and physical products without handling logistics. It streamlines gifting by managing delivery, fulfillment, and recipient experience.
- [Gumroad](https://composio.dev/toolkits/gumroad) - Gumroad is a platform for selling digital products, physical goods, and memberships with a simple checkout and marketing tools. It streamlines creator payouts and helps you grow your audience effortlessly.
- [Instacart](https://composio.dev/toolkits/instacart) - Instacart is an online grocery delivery and pickup service platform. It lets you discover local retailers and create shoppable lists and recipes with ease.
- [Junglescout](https://composio.dev/toolkits/junglescout) - Junglescout is an Amazon product research and analytics platform for sellers. It delivers sales estimates, competitive insights, and optimization tools to boost your Amazon business.
- [Ko fi](https://composio.dev/toolkits/ko_fi) - Ko-fi is a platform that lets creators receive donations, memberships, and sales from fans. It helps creators monetize their work and grow their audience with minimal friction.
- [Lemon squeezy](https://composio.dev/toolkits/lemon_squeezy) - Lemon Squeezy is a payments and subscription platform built for software companies. It makes managing payments, taxes, and customer subscriptions effortless.

## Frequently Asked Questions

### Do I need my own developer credentials to use Order Desk with Composio?

Yes, Order Desk requires you to configure your own API key. Once set up, Composio handles secure credential storage and API request handling for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)