src/tools/drive/createDocument.ts

import type { FastMCP } from 'fastmcp';
import { UserError } from 'fastmcp';
import { z } from 'zod';
import { drive_v3 } from 'googleapis';
import { getDriveClient, getDocsClient } from '../../clients.js';
import { insertMarkdown, formatInsertResult } from '../../markdown-transformer/index.js';

export function register(server: FastMCP) {
  server.addTool({
    name: 'createDocument',
    description:
      'Creates a new empty Google Document. Optionally places it in a specific folder and adds initial text content.',
    parameters: z.strictObject({
      title: z.string().min(1).describe('Title for the new document.'),
      parentFolderId: z
        .string()
        .optional()
        .describe(
          'ID of folder where document should be created. If not provided, creates in Drive root.'
        ),
      initialContent: z
        .string()
        .optional()
        .describe(
          'Initial content to add to the document. By default, markdown syntax is converted to formatted Google Docs content (headings, bold, italic, links, lists, etc.).'
        ),
      contentFormat: z
        .enum(['markdown', 'raw'])
        .optional()
        .default('markdown')
        .describe(
          "How to interpret initialContent. 'markdown' (default) converts markdown to formatted Google Docs content. 'raw' inserts the text as-is without any conversion."
        ),
    }),
    execute: async (args, { log }) => {
      const drive = await getDriveClient();
      log.info(`Creating new document "${args.title}"`);

      try {
        const documentMetadata: drive_v3.Schema$File = {
          name: args.title,
          mimeType: 'application/vnd.google-apps.document',
        };

        if (args.parentFolderId) {
          documentMetadata.parents = [args.parentFolderId];
        }

        const response = await drive.files.create({
          requestBody: documentMetadata,
          fields: 'id,name,webViewLink',
          supportsAllDrives: true,
        });

        const document = response.data;

        // Add initial content if provided
        if (args.initialContent) {
          try {
            const docs = await getDocsClient();
            if (args.contentFormat === 'raw') {
              await docs.documents.batchUpdate({
                documentId: document.id!,
                requestBody: {
                  requests: [
                    {
                      insertText: {
                        location: { index: 1 },
                        text: args.initialContent,
                      },
                    },
                  ],
                },
              });
            } else {
              const result = await insertMarkdown(docs, document.id!, args.initialContent, {
                startIndex: 1,
                firstHeadingAsTitle: true,
              });
              log.info(formatInsertResult(result));
            }
          } catch (contentError: any) {
            log.warn(`Document created but failed to add initial content: ${contentError.message}`);
          }
        }

        return JSON.stringify(
          {
            id: document.id,
            name: document.name,
            url: document.webViewLink,
          },
          null,
          2
        );
      } catch (error: any) {
        log.error(`Error creating document: ${error.message || error}`);
        if (error.code === 404)
          throw new UserError('Parent folder not found. Check the folder ID.');
        if (error.code === 403)
          throw new UserError(
            'Permission denied. Make sure you have write access to the destination folder.'
          );
        throw new UserError(`Failed to create document: ${error.message || 'Unknown error'}`);
      }
    },
  });
}