Firebase Admin API Skill
Overview
Firebase Admin SDK allows privileged server environments to interact with Firestore, Auth, and Cloud Messaging.
Installation
npm install firebase-admin
pip install firebase-admin
Authentication
Authenticate using a Google Cloud Service Account key JSON file or Application Default Credentials (ADC).
Core Concepts
- Firestore: NoSQL document database.
- Custom Tokens: JWTs minted on the server to log users into the client SDK.
- FCM: Firebase Cloud Messaging for push notifications.
Common Workflows
- Initialize
initializeApp({ credential: cert(serviceAccount) }). - Access Firestore:
getFirestore(). - Perform operations bypassing security rules.
Error Handling
Catch FirebaseError. Error codes match RPC statuses (e.g., not-found, already-exists).
Security
Service accounts have absolute God-mode access. Never deploy an Admin SDK service account key to a client application.
Rate Limits
Firestore allows 10,000 writes per second per database. Batch operations are limited to 500 documents per batch.
Best Practices
Use batch() for multiple writes to ensure atomicity. Use runTransaction() when a write depends on the current value of a document.
Troubleshooting
If initialized multiple times, the SDK throws a 'default app already exists' error. Check getApps().length before initializing.
References
Why use this skill
Use this when your agent works with firebase — structured patterns beat pasted docs and prevent common hallucinations.
AI pitfalls
- Inventing column names or schema fields
- Using deprecated driver methods or wrong connection strings
- Omitting connection pooling or transaction boundaries
Production checklist
- Migrations version-controlled and applied via CI
- Connection limits and pooling configured
- Backups and restore procedure documented
Related skills
- No graph relationships yet — see the knowledge graph in the docs site.
Last Verified: 2026-07-02