> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokencraft.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# create_workspace

> Create a new workspace for organizing design tokens

# create\_workspace

Creates a new workspace to organize your design tokens and tokensets.

## Tool Schema

```json theme={null}
{
  "name": "create_workspace",
  "description": "Create a new workspace",
  "inputSchema": {
    "type": "object",
    "properties": {
      "name": {
        "type": "string",
        "minLength": 1,
        "maxLength": 255,
        "description": "The name of the workspace"
      },
      "description": {
        "type": "string",
        "description": "Optional description of the workspace"
      }
    },
    "required": ["name"]
  }
}
```

## Parameters

| Parameter     | Type   | Required | Description                                  |
| ------------- | ------ | -------- | -------------------------------------------- |
| `name`        | string | Yes      | The name of the workspace (1-255 characters) |
| `description` | string | No       | Optional description of the workspace        |

## Response

```json theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "New Design System",
  "description": "Workspace for the new product design system",
  "created_at": "2025-01-20T15:30:00Z",
  "updated_at": "2025-01-20T15:30:00Z"
}
```

## Example Usage in Claude

### Create a Simple Workspace

```
You: Create a new workspace called "Mobile App Design System"

Claude: I'll create a new workspace for your mobile app design system.

Workspace created successfully:
- **Name**: Mobile App Design System
- **ID**: 550e8400-e29b-41d4-a716-446655440000
- **Description**: (none)
```

### Create Workspace with Description

```
You: Create a workspace called "Marketing Website" with description "Design tokens for the marketing website redesign"

Claude: I'll create the marketing website workspace with your description.

Workspace created successfully:
- **Name**: Marketing Website
- **ID**: 550e8400-e29b-41d4-a716-446655440001
- **Description**: Design tokens for the marketing website redesign
```

## Common Use Cases

### 1. New Product Launch

```
You: I need to create a workspace for our new mobile app design system
```

### 2. Project Organization

```
You: Create separate workspaces for web, mobile, and marketing designs
```

### 3. Client Work

```
You: Set up a workspace for the Acme Corp design system
```

## Notes

* Workspace names must be unique within your account
* Workspaces can contain multiple tokensets
* You can create as many workspaces as needed for different projects or clients
* Workspaces help organize related design tokens logically

## See Also

* [list\_workspaces](/mcp/tools/list-workspaces) - View all your workspaces
* [get\_workspace](/mcp/tools/get-workspace) - Get workspace details
* [update\_workspace](/mcp/tools/update-workspace) - Modify workspace information
* [create\_tokenset](/mcp/tools/create-tokenset) - Create tokensets within a workspace