diff --git a/connectors/trello.mdx b/connectors/trello.mdx
new file mode 100644
index 0000000..caeb07a
--- /dev/null
+++ b/connectors/trello.mdx
@@ -0,0 +1,73 @@
+---
+title: Trello
+description: Connect Trello to index boards, lists, and cards
+---
+
+The Trello connector indexes cards and their content from your Trello boards.
+
+## What gets indexed
+
+- Cards (titles, descriptions, comments, checklists, attachments)
+- Card metadata (board name, list name, labels, assigned members, due dates)
+
+
+ Private boards stay private, and are only searchable by users who have access to them. Boards and lists are not independently searchable—they appear as metadata on cards.
+
+
+## Setup
+
+
+
+ 1. In Grapevine, go to [**Integrations**](https://app.getgrapevine.ai/integrations) and click on **Trello**
+ 2. Click **Connect Trello Account** to begin the authorization process
+
+
+
+ 1. You'll be redirected to Trello to authorize the Grapevine Power-Up
+ 2. Review the requested permissions
+ 3. Click **Allow** to grant access
+
+
+ You need admin permissions on your Trello workspace to install the Power-Up.
+
+
+
+
+ 1. Complete the OAuth 1.0 authentication handshake
+ 2. The Grapevine Power-Up will be installed as a headless Power-Up
+ 3. Authorization will apply to all boards accessible to your account
+
+
+
+ Grapevine will automatically begin indexing your Trello boards and cards. The initial sync may take time depending on the number of boards and cards in your workspace.
+
+
+
+## Permissions
+
+The Trello connector respects Trello permissions:
+
+- All boards accessible to the authorized account are indexed
+- Private boards remain private and are only searchable by authorized users
+- Board-level permissions are preserved in search results
+- Admin permissions required for initial setup and to index private boards
+
+
+ Admin privileges are required to receive webhook events from private boards. If the authorized account loses admin status in an organization, private boards in that organization will no longer sync.
+
+
+## Sync behavior
+
+
+ The initial indexing processes all accessible boards and cards. For large workspaces (100+ boards), rate limiting is applied and the sync may take several hours. Real-time updates are configured automatically via webhooks.
+
+
+- **Initial sync** - Begins automatically after authorization
+- **Ongoing syncs** - Real-time updates via webhooks keep your index current
+- **Deletions** - Deleted cards and boards are removed from the index automatically
+
+## Limitations
+
+- Card attachment metadata is indexed, but file contents are not processed
+- Archived boards and cards are not indexed
+- Admin permissions required to index private boards
diff --git a/docs.json b/docs.json
index 9e87ccc..29b7324 100644
--- a/docs.json
+++ b/docs.json
@@ -50,7 +50,8 @@
"connectors/google-drive",
"connectors/google-email",
"connectors/hubspot",
- "connectors/gong"
+ "connectors/gong",
+ "connectors/trello"
]
}
]