PDF Text Writing Tool

PDFTextWritingTool

Description

Write text at precise coordinates on a PDF page, optionally embedding a custom TrueType font.

Parameters

Run Parameters

• pdf_path (str, required): Path to the input PDF.
• text (str, required): Text to add.
• position (tuple[int, int], required): (x, y) coordinates.
• font_size (int, default 12)
• font_color (str, default "0 0 0 rg")
• font_name (str, default "F1")
• font_file (str, optional): Path to .ttf file.
• page_number (int, default 0)

Example

from crewai import Agent, Task, Crew
from crewai_tools import PDFTextWritingTool

tool = PDFTextWritingTool()

agent = Agent(
    role="PDF Editor",
    goal="Annotate PDFs",
    backstory="Documentation specialist",
    tools=[tool],
    verbose=True,
)

task = Task(
    description="Write 'CONFIDENTIAL' at (72, 720) on page 1 of ./sample.pdf",
    expected_output="Confirmation message",
    agent=agent,
)

crew = Crew(
    agents=[agent],
    tasks=[task],
    verbose=True,
)

result = crew.kickoff()

Direct usage

from crewai_tools import PDFTextWritingTool

PDFTextWritingTool().run(
  pdf_path="./input.pdf",
  text="CONFIDENTIAL",
  position=(72, 720),
  font_size=18,
  page_number=0,
)

Tips

• Coordinate origin is the bottom‑left corner.
• If using a custom font (font_file), ensure it is a valid .ttf.