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

# base44 connectors pull

> Pull connector configurations from Base44 to local files. Replaces all local connector configs with the remote versions.

<Warning>
  This page is part of an AI coding agent skill and is written for agents, not humans. For the human-readable Base44 docs, see the [developer documentation](/developers).
</Warning>

# base44 connectors pull

Pull connector configurations from Base44 to local files. Replaces all local connector configs with the remote versions.

## Syntax

```bash theme={null}
npx base44 connectors pull
```

## Authentication

**Required**: Yes. If not authenticated, you'll be prompted to login first.

## What It Does

1. Fetches all connectors from Base44
2. Writes connector files to the `base44/connectors/` directory
3. Deletes local connector files that don't exist remotely
4. Reports written and deleted connectors

## Prerequisites

* Must be run from a Base44 project directory
* Project must be linked to a Base44 app

## Output

```bash theme={null}
$ npx base44 connectors pull

Fetching connectors from Base44...
✓ Connectors fetched successfully

Syncing connector files...
✓ Connector files synced successfully

Written: googlecalendar, slack
Deleted: notion

Pulled 2 connectors to base44/connectors
```

## Connector Synchronization

The pull operation synchronizes remote connectors to your local files:

* **Written**: Connector files created or updated from remote
* **Deleted**: Local connector files removed (didn't exist remotely)
* **Up to date**: If no changes needed, reports "All connectors are already up to date"

**Warning**: This operation replaces all local connector configurations with remote versions. Any local changes not pushed to Base44 will be overwritten.

## Error Handling

If no connectors exist on Base44:

```bash theme={null}
$ npx base44 connectors pull
All connectors are already up to date
```

## Use Cases

* Sync connector configurations to a new development machine
* Get the latest connector configurations from your team
* Restore local connector files after accidental deletion
* Start working on an existing project with connectors

## Notes

* Connector files are stored as `.jsonc` in the `base44/connectors/` directory
* The directory location is configurable via `connectorsDir` in `config.jsonc`
* Use `base44 connectors push` to upload local changes to Base44

## Related Commands

* [connectors-create.md](https://docs.base44.com/developers/skills/base44-cli/references/connectors-create.md) - How to create connector configuration files
* [connectors-push.md](https://docs.base44.com/developers/skills/base44-cli/references/connectors-push.md) - Push local connectors to Base44