Outline Wiki MCP Server

Instructions

Implementation Reference

• src/lib/handlers/batch.ts:35-54 (handler)

  The main handler function for batch_create_documents. It checks access, then uses runBatch to create multiple documents via API calls to '/documents.create', handling errors and returning batch summary.

  async batch_create_documents(args: BatchCreateDocumentsInput) {
    checkAccess(config, 'batch_create_documents');
  
    return runBatch(args.documents, async (doc) => {
      try {
        const { data } = await apiCall(() =>
          apiClient.post<OutlineDocument>('/documents.create', {
            title: doc.title,
            text: doc.text,
            collectionId: doc.collectionId,
            parentDocumentId: doc.parentDocumentId,
            publish: doc.publish,
          })
        );
        return { success: true, id: data.id, title: data.title };
      } catch (error) {
        return { success: false, title: doc.title, error: getErrorMessage(error) };
      }
    });
  },

• src/lib/schemas.ts:112-120 (schema)

  Zod schema definition for batchCreateDocuments input, validating an array of document objects with title, text, collectionId, etc.

  export const batchCreateDocumentsSchema = z.object({
    documents: z.array(z.object({
      title: z.string().min(1),
      text: z.string().default(''),
      collectionId,
      parentDocumentId: z.string().uuid().optional(),
      publish: z.boolean().default(true),
    })).min(1, 'At least one document is required'),
  });

• src/lib/tools.ts:174-176 (registration)

  Tool registration in allTools array using createTool, which converts the Zod schema to JSON schema for MCP tool definition.

  'batch_create_documents',
  'Create multiple documents at once.',
  'batch_create_documents'