Firebase MCP Server

Instructions

Implementation Reference

• src/lib/firebase/firestoreClient.ts:119-133 (handler)

  Executes the firestore_add_document tool: adds a document to Firestore collection and returns ID, console URL, and processed data.
  export async function addDocument(collection: string, data: any) { try { if (!db) { return { content: [{ type: 'text', text: 'Firebase is not initialized. SERVICE_ACCOUNT_KEY_PATH environment variable is required.' }], isError: true }; } const docRef = await db.collection(collection).add(data); const projectId = getProjectId(); convertTimestampsToISO(data); const consoleUrl = `https://console.firebase.google.com/project/${projectId}/firestore/data/${collection}/${docRef.id}`; return { content: [{ type: 'text', text: JSON.stringify({ id: docRef.id, url: consoleUrl, document: data }) }] }; } catch (error) { return { content: [{ type: 'text', text: `Error adding document: ${(error as Error).message}` }], isError: true }; } }
• src/index.ts:40-53 (schema)

  Input schema for firestore_add_document tool defining collection and data parameters.
  inputSchema: { type: 'object', properties: { collection: { type: 'string', description: 'Collection name' }, data: { type: 'object', description: 'Document data' } }, required: ['collection', 'data'] }
• src/index.ts:37-54 (registration)

  Registration of firestore_add_document tool in ListToolsRequestSchema handler.
  { name: 'firestore_add_document', description: 'Add a document to a Firestore collection', inputSchema: { type: 'object', properties: { collection: { type: 'string', description: 'Collection name' }, data: { type: 'object', description: 'Document data' } }, required: ['collection', 'data'] } },
• src/index.ts:229-230 (registration)

  Dispatch to handler in CallToolRequestSchema switch statement.
  case 'firestore_add_document': return addDocument(args.collection as string, args.data as object);
• src/lib/firebase/firestoreClient.ts:51-58 (helper)

  Helper utility to convert Firestore Timestamps to ISO strings, used in addDocument.
  function convertTimestampsToISO(data: any) { for (const key in data) { if (data[key] instanceof Timestamp) { data[key] = data[key].toDate().toISOString(); } } return data; }