Django Firebase
A production-ready Django app implementing Firebase Model Context Protocol (MCP) server with 14 Firebase tools for AI agents. Features standalone agent, HTTP/stdio transport, LangChain integration, and complete Firebase service coverage (Auth, Firest
What is Django Firebase?
Django Firebase is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to production-ready django app implementing firebase model context protocol (mcp) server with 14 firebase tools for ai agents. features standalone agent, http/stdio transport, langchain integration, and ...
A production-ready Django app implementing Firebase Model Context Protocol (MCP) server with 14 Firebase tools for AI agents. Features standalone agent, HTTP/stdio transport, LangChain integration, and complete Firebase service coverage (Auth, Firest
This server falls under the APIs and Cloud Services categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A production-ready Django app implementing Firebase Model Co
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx django-firebaseConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Django Firebase
Django Firebase MCP is a production-ready Django application that implements a Firebase MCP server, giving AI agents access to 14 Firebase tools spanning Authentication, Firestore, and Cloud Storage. It supports both HTTP and stdio transports, integrates natively with LangChain and LangGraph agent frameworks, and ships with a standalone Firebase agent for immediate testing. Developers use it to build AI-powered backends that need to read and write Firebase data, verify user tokens, and manage file storage through natural language commands.
Prerequisites
- Python 3.10+ and pip
- A Firebase project with a service account JSON credentials file downloaded from the Firebase Console
- Django and the project dependencies installed via requirements.txt
- Redis (optional, for stateful agent sessions via USE_REDIS=true)
- An MCP-compatible client or LangChain/LangGraph agent setup
Clone the repository and install dependencies
Check out the project and install all Python dependencies including Django, Firebase Admin SDK, and LangChain packages.
git clone https://github.com/raghavdasila/django-firebase-mcp.git
cd django-firebase-mcp
pip install -r requirements.txtDownload your Firebase service account credentials
In the Firebase Console, go to Project Settings > Service Accounts > Generate new private key. Download the JSON file and place it somewhere accessible on your server.
Create the .env configuration file
Create a .env file in the project root with your Firebase credentials path, storage bucket, and Django settings. Set MCP_TRANSPORT to 'stdio' for Claude Desktop or 'http' for networked agent access.
SERVICE_ACCOUNT_KEY_PATH=/path/to/your/firebase-service-account.json
FIREBASE_STORAGE_BUCKET=your-project-id.appspot.com
MCP_TRANSPORT=stdio
MCP_HOST=0.0.0.0
MCP_PORT=8000
DEBUG=True
SECRET_KEY=your-django-secret-key-here
USE_REDIS=false
# REDIS_URL=redis://localhost:6379/0Run Django migrations and start the server
Apply database migrations and then start the Django development server which also serves the MCP endpoint.
python manage.py migrate
python manage.py runserverTest with the standalone Firebase agent
Run the built-in standalone agent script to verify your Firebase credentials and MCP tools are working correctly before connecting an AI client.
python firebase_admin_mcp/standalone_firebase_agent.pyConfigure Claude Desktop for stdio transport
Add the server to your Claude Desktop config to run it as a local stdio process. Claude will spawn the Django server automatically.
{
"mcpServers": {
"django-firebase": {
"command": "python",
"args": ["manage.py", "runserver"],
"env": {
"SERVICE_ACCOUNT_KEY_PATH": "/path/to/firebase-service-account.json",
"FIREBASE_STORAGE_BUCKET": "your-project-id.appspot.com",
"MCP_TRANSPORT": "stdio"
}
}
}
}Django Firebase Examples
Client configuration
Configure Claude Desktop to connect to the Django Firebase MCP server running locally with stdio transport.
{
"mcpServers": {
"django-firebase": {
"command": "python",
"args": ["/path/to/django-firebase-mcp/manage.py", "runmcpserver"],
"env": {
"SERVICE_ACCOUNT_KEY_PATH": "/path/to/firebase-credentials.json",
"FIREBASE_STORAGE_BUCKET": "your-project.appspot.com",
"MCP_TRANSPORT": "stdio",
"SECRET_KEY": "your-django-secret-key"
}
}
}
}Prompts to try
Example prompts to exercise the 14 Firebase tools across Authentication, Firestore, and Cloud Storage.
- "Show me all my Firestore collections."
- "Create a new Firestore document in the 'users' collection with name 'Alice' and role 'admin'."
- "Verify this Firebase ID token and tell me what user it belongs to."
- "List all files in my Firebase Storage bucket."
- "Query the 'orders' collection where status equals 'pending'."Troubleshooting Django Firebase
firebase_admin.exceptions.UnavailableError: failed to connect to Firebase
Verify that SERVICE_ACCOUNT_KEY_PATH points to a valid Firebase service account JSON file and that the file has the correct permissions. Also ensure your machine can reach Firebase APIs (firestore.googleapis.com, storage.googleapis.com) — check firewall rules if running in a corporate network.
FIREBASE_STORAGE_BUCKET causes storage errors even though it looks correct
The bucket name must be exactly as shown in Firebase Console under Storage — typically your-project-id.appspot.com or your-project-id.firebasestorage.app. Do not include gs:// prefix in the env variable value.
LangChain agent cannot find Firebase tools
Import the tools using from firebase_admin_mcp.tools import ALL_FIREBASE_TOOLS and pass the list to your LangChain agent's tools parameter. Ensure the Django app is fully initialized before importing by calling django.setup() if running outside of manage.py.
Frequently Asked Questions about Django Firebase
What is Django Firebase?
Django Firebase is a Model Context Protocol (MCP) server that production-ready django app implementing firebase model context protocol (mcp) server with 14 firebase tools for ai agents. features standalone agent, http/stdio transport, langchain integration, and complete firebase service coverage (auth, firest It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Django Firebase?
Follow the installation instructions on the Django Firebase GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Django Firebase?
Django Firebase works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Django Firebase free to use?
Yes, Django Firebase is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Django Firebase Alternatives — Similar APIs Servers
Looking for alternatives to Django Firebase? Here are other popular apis servers you can use with Claude, Cursor, and VS Code.
Kong
★ 43.4k🦍 The API and AI Gateway
API Mega List
★ 5.4kThis GitHub repo is a powerhouse collection of APIs you can start using immediately to build everything from simple automations to full-scale applications. One of the most valuable API lists on GitHub—period. 💪
Fetch
★ 5.4kFetch web content and convert to markdown for AI consumption
Fusio
★ 2.1kSelf-Hosted API Management for Builders
Korean Law
★ 1.8k국가법령정보MCP v4.0 | 법제처 41개 API → 17개 MCP 도구. 법령·판례·조례 검색 + LLM 환각 방지 인용검증 + 조문 영향 그래프(impact_map) + 시점 비교 자동 diff(time_travel) + 시민 5단계 실행 가이드(action_plan) | 41 Korean legal APIs → 17 MCP tools
RuleGo
★ 1.5k⛓️RuleGo is a lightweight, high-performance, embedded, next-generation component orchestration rule engine framework for Go.
Browse More APIs MCP Servers
Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Django Firebase in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Django Firebase?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.