Firebase MCP Server

Instructions

Implementation Reference

• src/lib/firebase/firestoreClient.ts:135-153 (handler)

  Implements the core logic for retrieving a specific document from a Firestore collection by collection name and document ID, including error handling, timestamp conversion, and generating console URL.
  export async function getDocument(collection: string, id: string) { try { if (!db) { return { content: [{ type: 'text', text: 'Firebase is not initialized. SERVICE_ACCOUNT_KEY_PATH environment variable is required.' }], isError: true }; } const doc = await db.collection(collection).doc(id).get(); if (!doc.exists) { return { content: [{ type: 'text', text: 'Document not found' }], isError: true }; } const projectId = getProjectId(); const data = doc.data(); convertTimestampsToISO(data); const consoleUrl = `https://console.firebase.google.com/project/${projectId}/firestore/data/${collection}/${id}`; return { content: [{ type: 'text', text: JSON.stringify({ id, url: consoleUrl, document: data }) }] }; } catch (error) { return { content: [{ type: 'text', text: `Error getting document: ${(error as Error).message}` }], isError: true }; } }
• src/index.ts:126-139 (schema)

  Defines the input schema for the firestore_get_document tool, specifying required collection and id parameters.
  inputSchema: { type: 'object', properties: { collection: { type: 'string', description: 'Collection name' }, id: { type: 'string', description: 'Document ID' } }, required: ['collection', 'id'] }
• src/index.ts:123-140 (registration)

  Registers the firestore_get_document tool in the MCP server's tool list, including name, description, and input schema.
  { name: 'firestore_get_document', description: 'Get a document from a Firestore collection', inputSchema: { type: 'object', properties: { collection: { type: 'string', description: 'Collection name' }, id: { type: 'string', description: 'Document ID' } }, required: ['collection', 'id'] } },
• src/index.ts:238-239 (registration)

  Registers the handler dispatch for firestore_get_document tool calls in the CallToolRequestHandler switch statement.
  case 'firestore_get_document': return getDocument(args.collection as string, args.id as string);
• src/lib/firebase/firestoreClient.ts:51-58 (helper)

  Utility function to convert Firestore Timestamp objects to ISO date strings, used in document retrieval.
  function convertTimestampsToISO(data: any) { for (const key in data) { if (data[key] instanceof Timestamp) { data[key] = data[key].toDate().toISOString(); } } return data; }