Home Page | Documentation | Examples | Discord | Blog

VoltAgent is an open source TypeScript framework for building and orchestrating AI agents.
Escape the limitations of no-code builders and the complexity of starting from scratch.

VoltAgent + VoltOps Actions + Airtable

This example shows how to expose VoltOps Actions as VoltAgent tools so your agent can create and read Airtable records on demand. The agent uses the standard createTool helper, but under the hood each tool forwards the request to the VoltOps Actions API. That means you get type-safe Airtable integration (create / list records) without having to build a custom REST client.

What You’ll Build

• A single VoltAgent powered by OpenAI’s gpt-4o-mini.
• VoltOps-integrated tools for every Airtable action:
  • listAirtableRecords
  • createAirtableRecord
  • updateAirtableRecord
  • deleteAirtableRecord
  • getAirtableRecord
• A shared VoltOps Actions client configured with your Volt console keys & Airtable credential.
• An optional MCP-powered agent that connects to VoltOps via MCPConfiguration and exposes the hosted Airtable tools (airtable_create_record, airtable_list_records, etc.) without custom TypeScript glue.

Prerequisites

1. Create (or pick) an Airtable base & table.
2. Connect Airtable inside the Volt console and note the credential ID.
3. Grab your Volt public and secret API keys, plus the Airtable base and table IDs.

Try the Example

npm create voltagent-app@latest -- --example with-voltagent-actions

Manual Setup

1. Install dependencies:

pnpm install

2. Create a .env file (copy from the snippet below).

cp .env.example .env

3. Run the agent:

pnpm dev

Open http://localhost:3141 and start a new session. Ask things like “Add Ada Lovelace to the workspace table” or “List the last five onboarding records”.

.env Template

VOLT_API_BASE_URL=https://api.voltagent.dev
VOLT_PUBLIC_KEY=pk_xxx
VOLT_SECRET_KEY=sk_xxx

# Airtable action defaults
AIRTABLE_CREDENTIAL_ID=cred_xxx
AIRTABLE_BASE_ID=appxxxxxxxxxxxxxx
AIRTABLE_TABLE_ID=tblxxxxxxxxxxxxxx

Any missing required value will throw during startup so you don’t accidentally run with an incomplete configuration.

Project Structure

with-voltagent-actions
├── src
│   ├── config.ts              # Loads env variables & instantiates the VoltOps Actions client
│   ├── index.ts               # Creates the agents (SDK + MCP) and wires up the VoltAgent server
│   └── tools
│       └── airtable.ts        # createTool definitions that call VoltOps actions
├── package.json
├── tsconfig.json
└── README.md

Key Ideas

• VoltOps Actions give you hosted, observable integrations. You call them through the SDK (@voltagent/sdk), but the experience inside the agent feels like any other Volt tool.
• If you prefer the MCP tool discovery model, the example also shows how to build an MCPConfiguration pointing at VoltOps (https://api.voltagent.dev/mcp/airtable or …/mcp/slack) and pass the resulting tools directly to an agent.
• You can reuse the same pattern for Gmail, Slack, GitHub, etc. – just swap the action ID and parameters.
• Tools return rich metadata (request + response payloads) so you can inspect what happened or feed it back into the conversation.

Happy building! 🎉