Firebase

Firebase MCP Server for Cloudflare Workers

Available Tools

40 tools available in the Firebase MCP server. Each tool can be called by AI assistants to perform specific actions.

firebase_auth_list_users

List Firebase Auth users.

Args:

maxResults: Maximum users to return (1-1000, default: 100)
pageToken: Pagination token from previous response
format: Response format ('json' or 'markdown')

Returns: List of users with their profile information.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 1000,
      "minimum": 1,
      "description": "Maximum users to return"
    }
  }
}

firebase_auth_get_user

Get a Firebase Auth user by UID.

Args:

uid: The user's unique ID
format: Response format

Returns: The user's profile information.

{
  "type": "object",
  "required": [
    "uid"
  ],
  "properties": {
    "uid": {
      "type": "string",
      "description": "User UID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

firebase_auth_get_user_by_email

Get a Firebase Auth user by email address.

Args:

email: The user's email address
format: Response format

Returns: The user's profile information.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "User email"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

firebase_auth_get_user_by_phone

Get a Firebase Auth user by phone number.

Args:

phoneNumber: The user's phone number (E.164 format, e.g., +1234567890)
format: Response format

Returns: The user's profile information.

{
  "type": "object",
  "required": [
    "phoneNumber"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "phoneNumber": {
      "type": "string",
      "description": "Phone number in E.164 format"
    }
  }
}

firebase_auth_create_user

Create a new Firebase Auth user.

Args:

email: User's email address
password: User's password (min 6 characters)
displayName: User's display name
phoneNumber: User's phone number (E.164 format)
photoUrl: URL to user's profile photo
emailVerified: Whether email is verified (default: false)
disabled: Whether account is disabled (default: false)

Returns: The created user.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "User email"
    },
    "disabled": {
      "type": "boolean",
      "default": false,
      "description": "Account disabled status"
    },
    "password": {
      "type": "string",
      "description": "User password"
    },
    "photoUrl": {
      "type": "string",
      "description": "Profile photo URL"
    },
    "displayName": {
      "type": "string",
      "description": "Display name"
    },
    "phoneNumber": {
      "type": "string",
      "description": "Phone number (E.164)"
    },
    "emailVerified": {
      "type": "boolean",
      "default": false,
      "description": "Email verified status"
    }
  }
}

firebase_auth_update_user

Update an existing Firebase Auth user.

Args:

uid: User's UID
email: New email address
password: New password
displayName: New display name
phoneNumber: New phone number
photoUrl: New profile photo URL
emailVerified: Email verified status
disabled: Account disabled status
customAttributes: Custom claims JSON string (max 1000 chars)

Returns: The updated user.

{
  "type": "object",
  "required": [
    "uid"
  ],
  "properties": {
    "uid": {
      "type": "string",
      "description": "User UID"
    },
    "email": {
      "type": "string"
    },
    "disabled": {
      "type": "boolean"
    },
    "password": {
      "type": "string"
    },
    "photoUrl": {
      "type": "string"
    },
    "displayName": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "emailVerified": {
      "type": "boolean"
    },
    "customAttributes": {
      "type": "string",
      "description": "Custom claims JSON"
    }
  }
}

firebase_auth_delete_user

Delete a Firebase Auth user.

Args:

uid: User's UID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "uid"
  ],
  "properties": {
    "uid": {
      "type": "string",
      "description": "User UID to delete"
    }
  }
}

firebase_auth_delete_users

Delete multiple Firebase Auth users at once.

Args:

uids: Array of user UIDs to delete (max 1000)

Returns: Success and failure counts.

{
  "type": "object",
  "required": [
    "uids"
  ],
  "properties": {
    "uids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User UIDs to delete"
    }
  }
}

firebase_auth_send_email_verification

Send an email verification link to a user.

Args:

email: User's email address

Returns: Confirmation that the email was sent.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "User email"
    }
  }
}

firebase_auth_send_password_reset

Send a password reset email to a user.

Args:

email: User's email address

Returns: Confirmation that the email was sent.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "User email"
    }
  }
}

firebase_auth_set_custom_claims

Set custom claims on a Firebase Auth user (for role-based access control).

Args:

uid: User's UID
claims: Custom claims object (e.g., { admin: true, role: "editor" })

Returns: Confirmation that claims were set.

{
  "type": "object",
  "required": [
    "uid",
    "claims"
  ],
  "properties": {
    "uid": {
      "type": "string",
      "description": "User UID"
    },
    "claims": {
      "type": "object",
      "description": "Custom claims object"
    }
  }
}

firebase_fcm_send_to_token

Send a push notification to a specific device token.

Args:

token: Device registration token
title: Notification title
body: Notification body
data: Optional custom data payload (string key-value pairs)

Returns: Message ID of the sent notification.

{
  "type": "object",
  "required": [
    "token",
    "title",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Notification body"
    },
    "data": {
      "type": "object",
      "description": "Custom data payload"
    },
    "title": {
      "type": "string",
      "description": "Notification title"
    },
    "token": {
      "type": "string",
      "description": "Device registration token"
    }
  }
}

firebase_fcm_send_to_topic

Send a push notification to all devices subscribed to a topic.

Args:

topic: Topic name (without /topics/ prefix)
title: Notification title
body: Notification body
data: Optional custom data payload (string key-value pairs)

Returns: Message ID of the sent notification.

{
  "type": "object",
  "required": [
    "topic",
    "title",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Notification body"
    },
    "data": {
      "type": "object",
      "description": "Custom data payload"
    },
    "title": {
      "type": "string",
      "description": "Notification title"
    },
    "topic": {
      "type": "string",
      "description": "Topic name"
    }
  }
}

firebase_fcm_send

Send an advanced FCM message with full configuration options.

Args:

message: Full FCM message object including:
- token: Target device token (use this OR topic OR condition)
- topic: Target topic name
- condition: Topic condition expression (e.g., "'TopicA' in topics && 'TopicB' in topics")
- notification: { title, body, image? }
- data: Custom string data payload
- android: Android-specific options
- apns: iOS-specific options
- webpush: Web push options

Returns: Message ID of the sent notification.

{
  "type": "object",
  "properties": {
    "ttl": {
      "type": "string"
    },
    "apns": {
      "type": "object"
    },
    "body": {
      "type": "string"
    },
    "data": {
      "type": "object"
    },
    "icon": {
      "type": "string"
    },
    "color": {
      "type": "string"
    },
    "image": {
      "type": "string"
    },
    "sound": {
      "type": "string"
    },
    "topic": {
      "type": "string"
    },
    "android": {
      "type": "object"
    },
    "message": {
      "type": "object",
      "description": "Full FCM message object"
    },
    "payload": {
      "type": "object"
    },
    "webpush": {
      "type": "object"
    },
    "priority": {
      "enum": [
        "normal",
        "high"
      ],
      "type": "string"
    },
    "channelId": {
      "type": "string"
    },
    "condition": {
      "type": "string"
    },
    "notification": {
      "type": "object"
    }
  }
}

firebase_firestore_list

List documents in a Firestore collection.

Args:

collectionPath: Path to the collection (e.g., "users" or "users/uid/posts")
pageSize: Number of documents to return (1-100, default: 20)
pageToken: Pagination token from previous response
format: Response format ('json' or 'markdown')

Returns: List of documents with their fields and metadata.

{
  "type": "object",
  "required": [
    "collectionPath"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of documents to return"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "collectionPath": {
      "type": "string",
      "description": "Path to the collection"
    }
  }
}

firebase_firestore_get

Get a single Firestore document by path.

Args:

documentPath: Full path to the document (e.g., "users/uid123")
format: Response format ('json' or 'markdown')

Returns: The document with all fields and metadata.

{
  "type": "object",
  "required": [
    "documentPath"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "documentPath": {
      "type": "string",
      "description": "Path to the document"
    }
  }
}

firebase_firestore_create

Create a new document in a Firestore collection.

Args:

collectionPath: Path to the collection
fields: Document fields as a JSON object
documentId: Optional custom document ID (auto-generated if not provided)

Returns: The created document.

{
  "type": "object",
  "required": [
    "collectionPath",
    "fields"
  ],
  "properties": {
    "fields": {
      "type": "object",
      "description": "Document fields"
    },
    "documentId": {
      "type": "string",
      "description": "Custom document ID"
    },
    "collectionPath": {
      "type": "string",
      "description": "Path to the collection"
    }
  }
}

firebase_firestore_update

Update an existing Firestore document.

Args:

documentPath: Path to the document
fields: Fields to update as a JSON object
updateMask: Optional list of field paths to update (updates all provided fields if not specified)

Returns: The updated document.

{
  "type": "object",
  "required": [
    "documentPath",
    "fields"
  ],
  "properties": {
    "fields": {
      "type": "object",
      "description": "Fields to update"
    },
    "updateMask": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Field paths to update"
    },
    "documentPath": {
      "type": "string",
      "description": "Path to the document"
    }
  }
}

firebase_firestore_delete

Delete a Firestore document.

Args:

documentPath: Path to the document

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "documentPath"
  ],
  "properties": {
    "documentPath": {
      "type": "string",
      "description": "Path to the document"
    }
  }
}

firebase_firestore_query

Query documents in a Firestore collection.

Args:

collectionPath: Path to the collection
where: Array of filter conditions [{ field, op, value }]
- op: LESS_THAN, LESS_THAN_OR_EQUAL, GREATER_THAN, GREATER_THAN_OR_EQUAL, EQUAL, NOT_EQUAL, ARRAY_CONTAINS, ARRAY_CONTAINS_ANY, IN, NOT_IN
orderBy: Array of ordering [{ field, direction: "ASCENDING" | "DESCENDING" }]
limit: Maximum number of documents to return
offset: Number of documents to skip
format: Response format

Returns: Matching documents.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Maximum documents to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Documents to skip"
    },
    "collectionPath": {
      "type": "string",
      "description": "Path to the collection"
    }
  }
}

firebase_firestore_batch_get

Get multiple documents by their paths in a single request.

Args:

documentPaths: Array of document paths to retrieve
format: Response format

Returns: The requested documents.

{
  "type": "object",
  "required": [
    "documentPaths"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "documentPaths": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of document paths"
    }
  }
}

firebase_firestore_list_collections

List collection IDs under a document or at the database root.

Args:

documentPath: Optional document path (lists root collections if not provided)
format: Response format

Returns: List of collection IDs.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "documentPath": {
      "type": "string",
      "description": "Document path (omit for root collections)"
    }
  }
}

firebase_firestore_list_indexes

List all composite indexes in the Firestore database.

Returns: List of indexes with their configuration.

{
  "type": "object",
  "properties": {}
}

firebase_firestore_create_index

Create a composite index in Firestore.

Args:

queryScope: COLLECTION or COLLECTION_GROUP
fields: Array of field configurations [{ fieldPath, order?, arrayConfig? }]

Returns: The created index (may be in CREATING state).

{
  "type": "object",
  "required": [
    "queryScope"
  ],
  "properties": {
    "queryScope": {
      "enum": [
        "COLLECTION",
        "COLLECTION_GROUP"
      ],
      "type": "string",
      "description": "Index query scope"
    }
  }
}

firebase_remoteconfig_get

Get the current Remote Config template.

Returns: The Remote Config template with parameters, conditions, and version info.

{
  "type": "object",
  "properties": {}
}

firebase_remoteconfig_update

Update the Remote Config template.

Args:

template: The updated template object with parameters and conditions
etag: ETag from the previous get operation (for concurrency control)

Returns: The updated Remote Config template.

{
  "type": "object",
  "required": [
    "etag"
  ],
  "properties": {
    "etag": {
      "type": "string",
      "description": "ETag from previous get (use * to force update)"
    }
  }
}

firebase_remoteconfig_rollback

Rollback Remote Config to a previous version.

Args:

versionNumber: Version number to rollback to

Returns: The rolled-back Remote Config template.

{
  "type": "object",
  "required": [
    "versionNumber"
  ],
  "properties": {
    "versionNumber": {
      "type": "string",
      "description": "Version number to rollback to"
    }
  }
}

firebase_remoteconfig_list_versions

List Remote Config version history.

Args:

pageSize: Number of versions to return (default: 10)
pageToken: Pagination token

Returns: List of version history entries.

{
  "type": "object",
  "properties": {
    "pageSize": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of versions"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    }
  }
}

firebase_rtdb_get

Read data from a Realtime Database path.

Args:

path: Database path (e.g., "users/uid123" or "posts")
orderBy: Field to order by (requires index)
limitToFirst: Limit to first N results
limitToLast: Limit to last N results
startAt: Start at value (for pagination)
endAt: End at value (for pagination)
equalTo: Filter by exact value
shallow: Return only keys (no nested data)

Returns: The data at the specified path.

{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Database path"
    },
    "endAt": {
      "type": "string",
      "description": "End at value"
    },
    "equalTo": {
      "type": "string",
      "description": "Equal to value"
    },
    "orderBy": {
      "type": "string",
      "description": "Field to order by"
    },
    "shallow": {
      "type": "boolean",
      "default": false,
      "description": "Return only keys"
    },
    "startAt": {
      "type": "string",
      "description": "Start at value"
    },
    "limitToLast": {
      "type": "integer",
      "minimum": 1,
      "description": "Limit to last N"
    },
    "limitToFirst": {
      "type": "integer",
      "minimum": 1,
      "description": "Limit to first N"
    }
  }
}

firebase_rtdb_set

Write data to a Realtime Database path (overwrites existing data).

Args:

path: Database path
data: Data to write (any JSON value)

Returns: Confirmation of write.

{
  "type": "object",
  "required": [
    "path",
    "data"
  ],
  "properties": {
    "data": {
      "description": "Data to write"
    },
    "path": {
      "type": "string",
      "description": "Database path"
    }
  }
}

firebase_rtdb_update

Update specific fields at a Realtime Database path (merges with existing data).

Args:

path: Database path
data: Fields to update (object with key-value pairs)

Returns: Confirmation of update.

{
  "type": "object",
  "required": [
    "path",
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "description": "Fields to update"
    },
    "path": {
      "type": "string",
      "description": "Database path"
    }
  }
}

firebase_rtdb_push

Push a new item to a Realtime Database list (auto-generates unique key).

Args:

path: Database path to the list
data: Data to push

Returns: The generated key for the new item.

{
  "type": "object",
  "required": [
    "path",
    "data"
  ],
  "properties": {
    "data": {
      "description": "Data to push"
    },
    "path": {
      "type": "string",
      "description": "Database path to list"
    }
  }
}

firebase_rtdb_delete

Delete data at a Realtime Database path.

Args:

path: Database path to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Database path to delete"
    }
  }
}

firebase_storage_list_buckets

List all Cloud Storage buckets in the project.

Returns: List of storage buckets with metadata.

{
  "type": "object",
  "properties": {}
}

firebase_storage_get_bucket

Get metadata for a Cloud Storage bucket.

Args:

bucketName: Name of the bucket

Returns: Bucket metadata.

{
  "type": "object",
  "required": [
    "bucketName"
  ],
  "properties": {
    "bucketName": {
      "type": "string",
      "description": "Bucket name"
    }
  }
}

firebase_storage_list_objects

List objects in a Cloud Storage bucket.

Args:

bucketName: Name of the bucket
prefix: Filter objects by prefix (folder path)
delimiter: Delimiter for hierarchical listing (usually "/")
maxResults: Maximum objects to return (1-1000)
pageToken: Pagination token
format: Response format

Returns: List of objects and prefixes (folders).

{
  "type": "object",
  "required": [
    "bucketName"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "prefix": {
      "type": "string",
      "description": "Filter by prefix"
    },
    "delimiter": {
      "type": "string",
      "description": "Delimiter for hierarchy"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "bucketName": {
      "type": "string",
      "description": "Bucket name"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 1000,
      "minimum": 1,
      "description": "Max results"
    }
  }
}

firebase_storage_get_object

Get metadata for a Cloud Storage object.

Args:

bucketName: Name of the bucket
objectName: Name/path of the object

Returns: Object metadata including size, content type, timestamps.

{
  "type": "object",
  "required": [
    "bucketName",
    "objectName"
  ],
  "properties": {
    "bucketName": {
      "type": "string",
      "description": "Bucket name"
    },
    "objectName": {
      "type": "string",
      "description": "Object name/path"
    }
  }
}

firebase_storage_delete_object

Delete an object from Cloud Storage.

Args:

bucketName: Name of the bucket
objectName: Name/path of the object to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "bucketName",
    "objectName"
  ],
  "properties": {
    "bucketName": {
      "type": "string",
      "description": "Bucket name"
    },
    "objectName": {
      "type": "string",
      "description": "Object name/path"
    }
  }
}

firebase_storage_copy_object

Copy an object within or between buckets.

Args:

sourceBucket: Source bucket name
sourceObject: Source object path
destBucket: Destination bucket name
destObject: Destination object path

Returns: The copied object metadata.

{
  "type": "object",
  "required": [
    "sourceBucket",
    "sourceObject",
    "destBucket",
    "destObject"
  ],
  "properties": {
    "destBucket": {
      "type": "string",
      "description": "Destination bucket"
    },
    "destObject": {
      "type": "string",
      "description": "Destination object path"
    },
    "sourceBucket": {
      "type": "string",
      "description": "Source bucket"
    },
    "sourceObject": {
      "type": "string",
      "description": "Source object path"
    }
  }
}

firebase_storage_update_metadata

Update custom metadata for a Cloud Storage object.

Args:

bucketName: Name of the bucket
objectName: Name/path of the object
metadata: Custom metadata key-value pairs

Returns: The updated object metadata.

{
  "type": "object",
  "required": [
    "bucketName",
    "objectName",
    "metadata"
  ],
  "properties": {
    "metadata": {
      "type": "object",
      "description": "Custom metadata"
    },
    "bucketName": {
      "type": "string",
      "description": "Bucket name"
    },
    "objectName": {
      "type": "string",
      "description": "Object name/path"
    }
  }
}