> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to AnyDB

The AnyDB connector lets your AI agent act in each user's AnyDB account. Each user connects their own AnyDB API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 18 tools.

**Authentication:** API Key
**Categories:** Databases, Productivity
**Tools:** 18: 7 read, 8 write, 3 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=ANYDB)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the AnyDB connection

   In **AgentKit > Connections**, create an AnyDB connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'anydb'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize AnyDB:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'anydb_auth_check',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "anydb"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize AnyDB:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="anydb_auth_check",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their AnyDB credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'anydb_auth_check',
  toolInput: {},
  connector: 'anydb',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="anydb_auth_check",
    tool_input={},
    connection_name="anydb",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `anydb_auth_check`

Check Authentication · Read-only

Check that the connected AnyDB API key and email are valid.
Returns the authentication result.
Use this to test the connection.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `anydb_databases_list`

List Databases · Read-only

List the databases in an AnyDB team.
Returns databases with their IDs (adbid) and names.
Use this to get an adbid for the record tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `teamid` (`string`, required): Team ID, from anydb_teams_list. Example: 507f1f77bcf86cd799439011.

Example input: `{"teamid":"<teamid>"}`

### `anydb_file_download_url_get`

Get File Download URL · Read-only

Get a temporary download or preview URL for a file stored in a record cell.
Returns the file URL.
Use anydb_record_get to find the record and cell position of the file.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `adbid` (`string`, required): Database ID, from anydb_databases_list. Example: 507f1f77bcf86cd799439012.
- `adoid` (`string`, required): Record ID, from anydb_records_list or anydb_records_search. Example: 507f1f77bcf86cd799439013.
- `cellpos` (`string`, required): Cell position where the file is stored. Example: A1.
- `teamid` (`string`, required): Team ID, from anydb_teams_list. Example: 507f1f77bcf86cd799439011.
- `preview` (`boolean`, optional): Set true for a preview URL instead of a download URL. Example: false.

Example input: `{"adbid":"<adbid>","adoid":"<adoid>","cellpos":"<cellpos>","teamid":"<teamid>"}`

### `anydb_record_get`

Get Record · Read-only

Get one AnyDB record with all its data.
Returns meta (adoid, adbid, teamid, name, description, status, assignees) and content cells keyed by position with key, type and value.
Use anydb_records_list or anydb_records_search to find record IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `adbid` (`string`, required): Database ID, from anydb_databases_list. Example: 507f1f77bcf86cd799439012.
- `adoid` (`string`, required): Record ID, from anydb_records_list or anydb_records_search. Example: 507f1f77bcf86cd799439013.
- `teamid` (`string`, required): Team ID, from anydb_teams_list. Example: 507f1f77bcf86cd799439011.

Example input: `{"adbid":"<adbid>","adoid":"<adoid>","teamid":"<teamid>"}`

### `anydb_records_list`

List Records · Read-only

List the records in an AnyDB database, optionally under one parent, of one template, filtered, sorted or grouped.
Returns items with record meta and preview cells, total, hasmore and lastmarker for the next page.
Use this to browse. Use anydb_records_search for a keyword search, or anydb_record_get for one record's full content.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `adbid` (`string`, required): Database ID, from anydb_databases_list. Example: 507f1f77bcf86cd799439012.
- `teamid` (`string`, required): Team ID, from anydb_teams_list. Example: 507f1f77bcf86cd799439011.
- `filter` (`string`, optional): Filter as a JSON string. Example: {"Status": "Active"}
- `groupby` (`string`, optional): Field to group results by. Example: Status.
- `lastmarker` (`string`, optional): The lastmarker from the previous page, to get the next page. Example: 507f1f77bcf86cd799439099.
- `pagesize` (`integer`, optional): Records per page. Defaults to 50. Example: 50.
- `parentid` (`string`, optional): Only records attached under this parent record ID (such as a folder). Example: 507f1f77bcf86cd799439014.
- `previewcells` (`string`, optional): Which cells to include in each item's preview, as a JSON string. Example: ["A1", "B1"]
- `sort` (`string`, optional): Sort order as a JSON string. Example: {"field": "name", "order": "asc"}
- `templateid` (`string`, optional): Only records created from this template ID. Example: 507f1f77bcf86cd799439015.
- `templatename` (`string`, optional): Only records of this template (type) name. Example: Project.

Example input: `{"adbid":"<adbid>","teamid":"<teamid>"}`

### `anydb_records_search`

Search Records · Read-only

Search the records of an AnyDB database by keyword.
Returns matching records with their meta.
Use this to find a record ID by text. Use anydb_records_list to browse with filters.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `adbid` (`string`, required): Database ID, from anydb_databases_list. Example: 507f1f77bcf86cd799439012.
- `search` (`string`, required): Keyword to search for. Example: Acme.
- `teamid` (`string`, required): Team ID, from anydb_teams_list. Example: 507f1f77bcf86cd799439011.
- `limit` (`integer`, optional): Maximum number of results. Example: 20.
- `parentid` (`string`, optional): Only records under this parent record ID. Example: 507f1f77bcf86cd799439014.
- `start` (`integer`, optional): Number of results to skip. Example: 0.

Example input: `{"adbid":"<adbid>","search":"<search>","teamid":"<teamid>"}`

### `anydb_teams_list`

List Teams · Read-only

List the AnyDB teams the connected user belongs to.
Returns teams with their IDs and names.
Use this first to get a teamid.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `anydb_record_copy`

Duplicate Record · Write

Duplicate an AnyDB record, optionally into another database or under another parent.
Returns the new record.
Choose how attachments are copied with attachments_mode.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `adbid` (`string`, required): Database ID, from anydb_databases_list. Example: 507f1f77bcf86cd799439012.
- `adoid` (`string`, required): Record ID, from anydb_records_list or anydb_records_search. Example: 507f1f77bcf86cd799439013.
- `teamid` (`string`, required): Team ID, from anydb_teams_list. Example: 507f1f77bcf86cd799439011.
- `attachmentsmode` (`string`, optional): How to handle attachments: noattachments, link (share the same files) or duplicate (copy files). Example: link. One of: `noattachments`, `link`, `duplicate`.
- `attachto` (`string`, optional): Parent record ID to attach the copy under. Example: 507f1f77bcf86cd799439014.
- `dstadbid` (`string`, optional): Database ID to copy into. Defaults to the same database. Example: 507f1f77bcf86cd799439017.

Example input: `{"adbid":"<adbid>","adoid":"<adoid>","teamid":"<teamid>"}`

### `anydb_record_create`

Create Record · Write

Create a record in an AnyDB database, optionally from a template and attached under a parent record.
Returns the new record with its adoid.
Use anydb_records_list with templatename to see how existing records of a type are filled.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `adbid` (`string`, required): Database ID, from anydb_databases_list. Example: 507f1f77bcf86cd799439012.
- `name` (`string`, required): Record name. Example: Acme Corp onboarding.
- `teamid` (`string`, required): Team ID, from anydb_teams_list. Example: 507f1f77bcf86cd799439011.
- `attach` (`string`, optional): Parent record ID to attach the new record under, such as a folder. Example: 507f1f77bcf86cd799439014.
- `content` (`object`, optional): Cell values to set, keyed by cell position (A1, B1, ...). Each cell is an object with a value and, for new cells, a key (field name) and type. Use anydb_record_get to see a record's cells and positions. Example: {"A1": {"key": "firstName", "type": "string", "value": "John"}, "B1": {"key": "age", "type": "number", "value": 25}}
- `template` (`string`, optional): Template record ID to create the record from. Example: 507f1f77bcf86cd799439015.
- `templatename` (`string`, optional): Template (type) name to create the record from. Example: Project.

Example input: `{"adbid":"<adbid>","name":"<name>","teamid":"<teamid>"}`

### `anydb_record_share_create`

Share Record · Write

Share an AnyDB record with users, emails or groups as viewers or editors, optionally with an expiry date.
Returns the share with its ID.
Use anydb_record_share_delete to remove it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `adbid` (`string`, required): Database ID, from anydb_databases_list. Example: 507f1f77bcf86cd799439012.
- `adoid` (`string`, required): Record ID, from anydb_records_list or anydb_records_search. Example: 507f1f77bcf86cd799439013.
- `role` (`string`, required): Access level for the people shared with. Example: viewer. One of: `viewer`, `editor`.
- `teamid` (`string`, required): Team ID, from anydb_teams_list. Example: 507f1f77bcf86cd799439011.
- `withattachments` (`string`, required): Whether attachments are shared too: true or false. Example: true. One of: `true`, `false`.
- `name` (`string`, optional): Name of the share. Example: Client view.
- `share_expiry_date` (`string`, optional): Date the share expires, as an ISO 8601 date. Example: 2026-12-31.
- `share_expiry_enable` (`boolean`, optional): Set true to make the share expire on share_expiry_date. Example: true.
- `shared_emails` (`string`, optional): Comma-separated email addresses to share with. Example: ana@example.com,bo@example.com.
- `shared_groupids` (`string`, optional): Comma-separated AnyDB group IDs to share with. Example: 507f1f77bcf86cd799439022.
- `shared_userids` (`string`, optional): Comma-separated AnyDB user IDs to share with. Example: 507f1f77bcf86cd799439021.

Example input: `{"adbid":"<adbid>","adoid":"<adoid>","role":"viewer","teamid":"<teamid>","withattachments":"true"}`

### `anydb_record_update`

Update Record · Write

Update an AnyDB record's name, description, status, follow-up, lock or cell values.
Returns the updated record.
Use anydb_record_get first to see cell positions.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `adbid` (`string`, required): Database ID of the record. Example: 507f1f77bcf86cd799439012.
- `adoid` (`string`, required): ID of the record to update. Example: 507f1f77bcf86cd799439013.
- `teamid` (`string`, required): Team ID of the record. Example: 507f1f77bcf86cd799439011.
- `content` (`object`, optional): Cell values to change, keyed by cell position, such as {"A1": {"value": "Updated value"}}. Example: {"A1": {"value": "Updated value"}, "B1": {"value": 25}}
- `description` (`string`, optional): New description. Example: Kick-off done, waiting on contract.
- `followup` (`number`, optional): Follow-up time as a Unix timestamp in milliseconds. Example: 1767225600000.
- `icon` (`string`, optional): Record icon. Example: 📁.
- `locked` (`boolean`, optional): Set true to lock the record against edits. Example: false.
- `name` (`string`, optional): New record name. Example: Acme Corp onboarding (phase 2)
- `status` (`string`, optional): New status. Example: In progress.

Example input: `{"adbid":"<adbid>","adoid":"<adoid>","teamid":"<teamid>"}`

### `anydb_webhook_register`

Register Webhook · Write

Register a webhook URL for an AnyDB team.
Returns the webhookId.
Then call anydb_webhook_subscribe to choose which record events it receives.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Webhook name. Example: CRM sync.
- `teamid` (`string`, required): Team ID, from anydb_teams_list. Example: 507f1f77bcf86cd799439011.
- `url` (`string`, required): URL that AnyDB POSTs events to. Example: https://example.com/hooks/anydb.
- `backoff_ms` (`integer`, optional): Wait between retries in milliseconds. Example: 2000.
- `custom_headers` (`object`, optional): Extra headers AnyDB sends with each delivery. Example: {"X-Source": "anydb"}
- `description` (`string`, optional): Webhook description. Example: Sends record changes to the CRM.
- `max_retries` (`integer`, optional): How many times to retry a failed delivery. Example: 3.
- `timeout` (`integer`, optional): Request timeout in milliseconds. Example: 10000.

Example input: `{"name":"<name>","teamid":"<teamid>","url":"<url>"}`

### `anydb_webhook_subscribe`

Subscribe Webhook to Event · Write

Subscribe a registered webhook to a record event (create, update or delete).
Returns the result.
Register the webhook first with anydb_webhook_register.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `event` (`string`, required): Record event: RECORD_CREATE, RECORD_UPDATE or RECORD_DELETE. Create and update events are debounced and may arrive late. Example: RECORD_UPDATE. One of: `RECORD_CREATE`, `RECORD_UPDATE`, `RECORD_DELETE`.
- `webhook_id` (`string`, required): Webhook ID returned by anydb_webhook_register. Example: 65f1c2d3e4b5a6978899aabb.

Example input: `{"event":"RECORD_CREATE","webhook_id":"<webhook_id>"}`

### `anydb_webhook_unsubscribe`

Unsubscribe Webhook from Event · Write

Stop a webhook from receiving one record event.
Returns the result.
Use anydb_webhook_delete to remove the webhook entirely.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `event` (`string`, required): Record event: RECORD_CREATE, RECORD_UPDATE or RECORD_DELETE. Create and update events are debounced and may arrive late. Example: RECORD_UPDATE. One of: `RECORD_CREATE`, `RECORD_UPDATE`, `RECORD_DELETE`.
- `webhook_id` (`string`, required): Webhook ID returned by anydb_webhook_register. Example: 65f1c2d3e4b5a6978899aabb.

Example input: `{"event":"RECORD_CREATE","webhook_id":"<webhook_id>"}`

### `anydb_webhook_update`

Update Webhook · Write

Update an AnyDB webhook's name, description, URL, timeout or custom headers.
Returns the updated webhook.
Use the webhookId from anydb_webhook_register.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `webhook_id` (`string`, required): Webhook ID returned by anydb_webhook_register. Example: 65f1c2d3e4b5a6978899aabb.
- `custom_headers` (`object`, optional): Extra headers AnyDB sends with each delivery. Example: {"X-Source": "anydb"}
- `description` (`string`, optional): New description. Example: Sends record changes to the new CRM.
- `name` (`string`, optional): New name. Example: CRM sync v2.
- `timeout` (`integer`, optional): Request timeout in milliseconds. Example: 10000.
- `url` (`string`, optional): New delivery URL. Example: https://example.com/hooks/anydb-v2.

Example input: `{"webhook_id":"<webhook_id>"}`

### `anydb_record_remove`

Remove Record · Destructive

Remove an AnyDB record from one or more parent records (detach it). Removing it from every parent deletes it.
Returns the result.
Use anydb_record_get to see where the record is attached.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `adbid` (`string`, required): Database ID, from anydb_databases_list. Example: 507f1f77bcf86cd799439012.
- `adoid` (`string`, required): Record ID, from anydb_records_list or anydb_records_search. Example: 507f1f77bcf86cd799439013.
- `removefromids` (`string`, required): Comma-separated IDs of the parent records to remove it from. Example: 507f1f77bcf86cd799439014,507f1f77bcf86cd799439016.
- `teamid` (`string`, required): Team ID, from anydb_teams_list. Example: 507f1f77bcf86cd799439011.

Example input: `{"adbid":"<adbid>","adoid":"<adoid>","removefromids":"<removefromids>","teamid":"<teamid>"}`

### `anydb_record_share_delete`

Remove Record Share · Destructive

Remove a record or form share so its people lose access.
Returns the result.
Use the share ID returned by anydb_record_share_create.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `share_id` (`string`, required): Share ID. Example: 65f1c2d3e4b5a69788990011.
- `sharetype` (`string`, required): Kind of share: item for a record share, form for a form share. Example: item. One of: `form`, `item`.
- `teamid` (`string`, required): Team ID, from anydb_teams_list. Example: 507f1f77bcf86cd799439011.

Example input: `{"share_id":"<share_id>","sharetype":"form","teamid":"<teamid>"}`

### `anydb_webhook_delete`

Delete Webhook · Destructive

Delete an AnyDB webhook and its event subscriptions.
Returns the result.
Use anydb_webhook_unsubscribe to stop only one event.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `webhook_id` (`string`, required): Webhook ID returned by anydb_webhook_register. Example: 65f1c2d3e4b5a6978899aabb.

Example input: `{"webhook_id":"<webhook_id>"}`

## Related

Other Databases connectors ([all 39](/agentkit/connectors/?category=databases)):

- [AWS Redshift](/agentkit/connectors/redshift/): Scalekit connector, Trusted identity provider, 10 tools
- [Google BigQuery](/agentkit/connectors/bigquery/): Scalekit connector, OAuth, 47 tools
- [Airtable](/agentkit/connectors/airtable/): Scalekit connector, OAuth, 26 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
