Outline Wiki MCP Server

Instructions

Implementation Reference

• src/lib/handlers/documents.ts:124-135 (handler)

  The core handler function that executes the delete_document tool logic by invoking the Outline API to delete the specified document, optionally permanently.

  async delete_document(args: DeleteDocumentInput) {
    checkAccess(config, 'delete_document');
    await apiCall(() =>
      apiClient.post('/documents.delete', { id: args.documentId, permanent: args.permanent })
    );
    return {
      success: true,
      documentId: args.documentId,
      permanent: args.permanent,
      message: args.permanent ? MESSAGES.DOCUMENT_DELETED_PERMANENT : MESSAGES.DOCUMENT_DELETED,
    };
  },

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

  Zod input schema for the delete_document tool defining documentId (required string) and permanent (optional boolean, defaults to false).

  export const deleteDocumentSchema = z.object({ documentId, permanent: z.boolean().default(false) });

• src/lib/tools.ts:103-106 (registration)

  Registers the MCP tool definition for delete_document, including name, description, and JSON schema derived from Zod schema.

    'delete_document',
    'Delete a document. If permanent=true, permanently delete; otherwise move to trash.',
    'delete_document'
  ),

• src/lib/handlers/index.ts:19-28 (registration)

  Combines and registers all handlers, including the document handlers (which contain delete_document) into a single ToolHandlers object.

  export function createAllHandlers(ctx: AppContext): ToolHandlers {
    return {
      ...createSearchHandlers(ctx),
      ...createDocumentHandlers(ctx),
      ...createCollectionHandlers(ctx),
      ...createCommentHandlers(ctx),
      ...createBatchHandlers(ctx),
      ...createSmartHandlers(ctx),
    } as ToolHandlers;
  }

• src/lib/access-control.ts:33-33 (helper)

  Includes 'delete_document' in the DELETE_TOOLS set used for access control checks to enforce delete restrictions.

  'delete_document',