> **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 Algodocs

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

**Authentication:** API Key
**Categories:** Files & Documents, AI
**Tools:** 7: 5 read, 2 write, 0 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=ALGODOCS)

## 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 Algodocs connection

   In **AgentKit > Connections**, create an Algodocs 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 = 'algodocs'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Algodocs:', 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: 'algodocs_extractors_list',
     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 = "algodocs"
   identifier = "user_123"

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

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

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Algodocs 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: 'algodocs_extracted_data_get',
  toolInput: {
    document_id: '<document_id>',
  },
  connector: 'algodocs',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="algodocs_extracted_data_get",
    tool_input={
        "document_id": "<document_id>",
    },
    connection_name="algodocs",
    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.

### `algodocs_extracted_data_get`

Get Extracted Data for Document · Read-only

Get the extraction result for one uploaded document.
Returns a list with one record per page or split record, each with documentId, fileName, folderId, processedAt, pageNumber, totalPages, download links (mediaOriginal, mediaExcel, mediaJson, mediaXml, mediaTxt, mediaCsv) and data holding the extractor's fields.
Poll until data is filled; data.error is set if the document was not recognized. Use algodocs_extracted_data_list for all documents of an extractor.

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

Inputs:

- `document_id` (`string`, required): ID of the document, returned by the upload tools (a number such as 182608). Example: 182608.

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

### `algodocs_extracted_data_list`

List Extracted Data · Read-only

List extraction results for every document processed by an extractor, optionally by folder or upload date.
Returns a list of records with documentId, fileName, folderId, timestamps, download links and data.
Use algodocs_extracted_data_get for one document.

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

Inputs:

- `extractor_id` (`string`, required): ID of the extractor whose results to list, from algodocs_extractors_list. Example: 6d86215bf9cb4fc6ac1f6967.
- `date` (`string`, optional): Only documents uploaded after this date (YYYY-MM-DD). Example: 2026-10-01.
- `folder_id` (`string`, optional): Only documents in this folder, from algodocs_folders_list. Example: 078f5vn8ocoy.
- `limit` (`integer`, optional): Maximum records to return. Defaults to 10000. Example: 50.

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

### `algodocs_extractors_list`

List Extractors · Read-only

List the extractors on the account (each one knows which fields to pull from a document type, such as invoices or bank statements).
Returns each extractor's id and name.
Use an id as extractor_id when uploading or reading extracted data.

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

Inputs: none.

Example input: `{}`

### `algodocs_folders_list`

List Folders · Read-only

List the folder tree that organizes uploaded documents.
Returns each folder's id, parentId (null for the root) and name.
Use an id as folder_id when uploading or to filter extracted data.

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

Inputs: none.

Example input: `{}`

### `algodocs_me_get`

Get Current User · Read-only

Get the Algodocs account tied to the API key.
Returns fullName and email.
Use this to check the connection.

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

Inputs: none.

Example input: `{}`

### `algodocs_document_upload_base64`

Upload Document as Base64 · Write

Upload a PDF or image as base64-encoded content and extract data from it with the given extractor.
Returns the new document's id, fileSize, fileMD5CheckSum and uploadedAt.
Use algodocs_document_upload_url when the file is at a public URL. Poll algodocs_extracted_data_get with the id. Uses page credits.

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

Inputs:

- `extractor_id` (`string`, required): ID of the extractor that should process the document, from algodocs_extractors_list. Example: 6d86215bf9cb4fc6ac1f6967.
- `file_base64` (`string`, required): The file's content, base64-encoded, without a data: prefix. Example: JVBERi0xLjcKJeLjz9MK...
- `filename` (`string`, required): Name to store the document under, with its extension. Example: invoice.pdf.
- `folder_id` (`string`, required): ID of the folder to store the document in, from algodocs_folders_list. Example: c40daa5550d9.

Example input: `{"extractor_id":"<extractor_id>","file_base64":"<file_base64>","filename":"<filename>","folder_id":"<folder_id>"}`

### `algodocs_document_upload_url`

Upload Document from URL · Write

Have Algodocs fetch a PDF or image from a public URL and extract data from it with the given extractor.
Returns the new document's id, fileSize, fileMD5CheckSum and uploadedAt.
Processing is asynchronous: poll algodocs_extracted_data_get with the id until data is filled. Uses page credits.

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

Inputs:

- `extractor_id` (`string`, required): ID of the extractor that should process the document, from algodocs_extractors_list. Example: 6d86215bf9cb4fc6ac1f6967.
- `folder_id` (`string`, required): ID of the folder to store the document in, from algodocs_folders_list. Example: c40daa5550d9.
- `url` (`string`, required): Public URL of the PDF or image to fetch and process. Example: https://api.algodocs.com/content/SampleInvoice.pdf.

Example input: `{"extractor_id":"<extractor_id>","folder_id":"<folder_id>","url":"<url>"}`

## Related

Other Files & Documents connectors ([all 76](/agentkit/connectors/?category=files-documents)):

- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Google Sheets](/agentkit/connectors/googlesheets/): Scalekit connector, OAuth, 48 tools
- [Google Drive](/agentkit/connectors/googledrive/): Scalekit connector, OAuth, 47 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 |
