feat(docs,drive): add styling tools and import_to_google_doc

[leolln]

Summary

Adds paragraph/heading styling tools for Google Docs and a file import tool for Google Drive.

Note: This PR has been refactored based on maintainer feedback to remove redundant tools and consolidate with existing functionality.

Google Docs styling tools

• format_paragraph_style: Paragraph formatting (alignment, line spacing, indentation, spacing above/below)
• apply_heading_style: Apply H1-H6 heading styles using namedStyleType for semantic document structure

Google Drive import tool

• import_to_google_doc: Import files (Markdown, DOCX, TXT, HTML, RTF, ODT) as native Google Docs with automatic format conversion and SSRF protection

Design decisions

Tools removed (redundant with existing functionality)

• format_text_style → use modify_doc_text() instead
• create_list → use insert_doc_elements(element_type="list") instead
• remove_list_formatting → use batch_update_doc() instead

Tools kept (unique functionality)

• format_paragraph_style: Paragraph-level properties not available in other tools
• apply_heading_style: Named style application (H1-H6) for semantic structure
• import_to_google_doc: New import capability with SSRF validation

Features

• Input validation for all parameters
• Comprehensive docstrings with usage examples
• Consistent error handling with existing tools
• Tool tier configuration included (extended tier)
• Rebased to v1.7.1 with updated dependencies

Test plan

• Tested format_paragraph_style with alignment and spacing options
• Tested apply_heading_style with H1-H6 levels
• Tested import_to_google_doc with markdown content
• Tested import_to_google_doc with local .md file
• Tested import_to_google_doc with local .docx file
• Verified SSRF protection blocks localhost/private IPs
• Server startup test (16 tools loaded)
• All imports successful

[taylorwilsdon]

This is great, appreciate the contribution! Few asks - can you move the helper functions to docs_helpers instead of in the tool file? Additionally, I'd love to consolidate the tools a bit to avoid tool pollution.

We've already got create_bullet_list_request available to insert_doc_elements so that should be able to handle list creation and removal is just a modify_doc_text call. I'm able to do both of those already today. We already also have the ability to format text pretty extensively with modify_doc_text. It already handles bold, italic, underline, font size, text and backgroudn color etc.

format_text_style: Rich text formatting (bold, italic, underline, strikethrough, font size/family, text/background colors)
format_paragraph_style: Paragraph formatting (alignment, line spacing, indentation)
apply_heading_style: Apply H1-H6 heading styles using namedStyleType for semantic structure
create_list: Convert paragraphs to bullet/numbered lists with nesting support
remove_list_formatting: Remove bullet/numbered list formatting

I'd consolidate into insert_doc_elements, modify_doc_text as needed and drop the bits that are already present. Thanks!

[leolln]

Hi @taylorwilsdon,

I've refactored the PR based on your feedback. Here's what changed:

✅ Removed Redundant Tools

Per your suggestion to consolidate with existing tools:

• Deleted format_text_style() - users should use modify_doc_text() instead
• Deleted create_list() - users should use insert_doc_elements() instead
• Deleted remove_list_formatting() - users should use batch_update_doc() instead
• Deleted _hex_to_rgb() helper - was duplicating _normalize_color() from docs_helpers

✅ Kept Unique Tools

These provide functionality not available elsewhere:

• format_paragraph_style() - paragraph-level properties (alignment, line spacing, indents)
• apply_heading_style() - applies Google Docs named styles (H1-H6)
• import_to_google_doc() - converts Markdown/DOCX/HTML to native Google Docs format

✅ Rebased to v1.7.1

• Clean rebase with no conflicts
• Dependencies updated (fastmcp 2.12.5 → 2.14.1)
• All tests passing

Testing

✓ All imports successful
✓ format_text_style correctly removed
✓ create_list correctly removed
✓ remove_list_formatting correctly removed
✓ _hex_to_rgb correctly removed
✓ format_paragraph_style exists
✓ apply_heading_style exists
✓ import_to_google_doc exists in drive_tools
✓ Server starts successfully
✓ Tool registration working (16 tools loaded)

Summary

Before refactoring: +743 lines (5 new styling tools + 1 import tool)
After refactoring: +447 lines (2 unique styling tools + 1 import tool)

The PR is now much cleaner and follows the existing architecture better. Let me know if you'd like any other changes!