Description

🔥 n8n Cloud Firestore Node

Your complete Cloud Firestore toolkit for n8n. Go beyond simple CRUD with powerful search operations, wildcard queries, and real-time triggers featuring built-in data validation. Handles native data types like Timestamps and GeoPoints seamlessly.

This node package provides two core components:

1. Cloud Firestore (Action Node): Perform all database operations.
2. Cloud Firestore Trigger (Trigger Node): Start workflows based on database events.

Core Features

1. Action Node (CRUD + Search)

• Create: Create a new document with an automatic ID (using collection/{id}) or a specific ID (using collection/docId).
• Read: Get a single document by its exact path.
• Update: Modify fields on an existing document.
• Delete: Permanently remove a document.
• 🚀 Advanced Search: Run complex queries against a collection using an intuitive UI. Filter documents with a dynamic list of conditions, including:
  • Equal to (==)
  • Not Equal to (!=)
  • Greater Than (>), Less Than (<), etc.
  • Array Contains / In / Not In
  • Exists (is not null) / Not Exists (is null)
  • Is Empty / Is Not Empty

2. Real-Time Trigger Node

• On Document Created: Starts a workflow when any new document is added to a collection.
• On Document Modified: Triggers when a specific document path is changed.
• On Collection Modified: Triggers when any document within a collection is modified.

3. Advanced Features (What makes this node unique)

• ⚡ Wildcard Collection Group Search: Perform searches across all sub-collections with a matching name using the path format parentCollection/{}/subCollectionName.
• 🛡️ Trigger Filtering: Stop noisy workflows! For the On Document Modified and On Collection Modified triggers, you can add filters (using the exact same UI as the Search action). The workflow will only run if the modified document's data passes all validation conditions.
• 🔄 Native Data Type Handling: Automatically converts Firestore's Timestamp and GeoPoint objects into clean, usable JSON (ISO 8601 strings and {lat, lon} objects) and vice-versa.
• Nested Path Support: All filter keys (in Search and Triggers) support dot notation (user.address.city) to query or validate nested map fields.

Installation

1. n8n Community Install (Recommended)

1. In your n8n instance, go to Settings > Community Nodes.
2. Click Install a community node.
3. Enter the npm package name: n8n-nodes-firestore.
4. Click Install. Your n8n instance will restart, and the nodes will be available.

2. Manual / Docker Install

If you are running a self-hosted instance (especially with Docker), you may need to install the node manually.

Docker

Add the following line to your n8n Docker environment variables:
N8N_CUSTOM_EXTENSIONS=n8n-nodes-firestore

On restart, the image will automatically download the node.

Local Install (npm)

For non-Docker self-hosted instances, navigate to your n8n user data directory (usually ~/.n8n/) and install via npm:

# Go to your n8n directory
cd ~/.n8n

# Install the package
npm install n8n-nodes-firestore

# Restart your n8n instance