# Workiom — how to use (mcp.ai)

Connect your Workiom account and use 3 tools for productivity straight from your AI agent. Connect with your own API key. Workiom allows businesses to create custom workflows, integrate apps, and automate processes, reducing manual overhead and streamlining operations.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_workiom?ms=1787291220000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `workiom_create_record`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/workiom`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/workiom/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/workiom/create/record` — Creates a new record in a specified Workiom list. This tool creates a record with basic field types like text, numbers, dates, and static list items. The record data should be provided as a JSON objec
  - body: { list_id: string, record_data: object }
- `POST https://api.mcp.ai/api/workiom/get/all/lists` — Get all lists from a Workiom app. This action fetches all lists within a specific Workiom app. Lists are containers for records (similar to database tables) and are the fundamental data structure in W
  - body: { app_id: string }
- `POST https://api.mcp.ai/api/workiom/get/records` — Retrieves records from a specified Workiom list. Use this action to fetch data from a Workiom list. The list_id is required and can be obtained from the WORKIOM_GET_ALL_LISTS action. Each record conta
  - body: { filters?: object[], list_id: string, sorting?: string, skip_count?: integer, max_result_count?: integer }

## Example prompts
- "What can I do in Workiom?"
- "Show me a summary of my Workiom account"

## More
- Page: https://mcp.ai/workiom
- Agent spec (llms.txt): https://mcp.ai/workiom/llms.txt
- Postman collection: https://mcp.ai/workiom/postman.json