firestore_add_document

Add a document to a Firestore collection by specifying the collection name and document data. This tool enables structured data storage in Firebase's NoSQL database.

Instructions

Add a document to a Firestore collection

Input Schema

TableJSON Schema

Name	Required	Description	Default
`collection`	Yes	Collection name
`data`	Yes	Document data

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;
}

Firebase MCP Server