Skip to content

Add comprehensive comment management functionality#15

Merged
a-bonus merged 4 commits intoa-bonus:mainfrom
justinkistner:feature/comment-management
Aug 6, 2025
Merged

Add comprehensive comment management functionality#15
a-bonus merged 4 commits intoa-bonus:mainfrom
justinkistner:feature/comment-management

Conversation

@justinkistner
Copy link
Copy Markdown
Contributor

@justinkistner justinkistner commented Aug 4, 2025

This PR adds complete comment management capabilities to the Google Docs MCP server, addressing a major feature gap for document collaboration workflows.

New Features

  • listComments - View all comments with author, date, and quoted text
  • getComment - Get specific comment details with replies
  • addComment - Create new comments anchored to text ranges
  • replyToComment - Add replies to existing comments
  • resolveComment - Mark comments as resolved
  • deleteComment - Remove comments from documents

Technical Implementation

  • Uses Google Drive API v3 with proper fields parameter for accurate quoted text extraction
  • Follows existing MCP server patterns for error handling and tool structure
  • Includes comprehensive TypeScript types and validation
  • Updated README documentation

Testing

  • Tested successfully on real Google Docs with existing comments
  • Verified quoted text extraction shows actual anchored text content
  • All comment operations working as expected

This enhancement enables AI assistants to fully participate in document review and collaboration workflows through the MCP protocol.

- Implement 6 new comment tools: listComments, getComment, addComment, replyToComment, resolveComment, deleteComment
- Use Google Drive API v3 with proper fields parameter for accurate quoted text extraction
- Add complete comment workflow support for Google Docs collaboration
- Update README documentation with new comment features
- Add index.js entry point for running compiled server

This addresses a major feature gap in Google Docs MCP server by enabling full comment management capabilities.
- Remove hardcoded 4000 character limit that was truncating long documents
- Add optional maxLength parameter for user-controlled truncation
- Improve text extraction to handle tables and other document elements
- Provide clear feedback about document size and any applied limits
- Default behavior now returns full document content without truncation
- Add convertDocsJsonToMarkdown function with full document structure support
- Handle paragraphs, headings, lists, tables, and text formatting
- Support bold, italic, underline, strikethrough, and links in markdown
- Convert Google Docs tables to markdown table format
- Add proper heading hierarchy (H1-H6) and list formatting
- Include enhanced debugging for truncation issue investigation
- Remove NotImplementedError for markdown format
@a-bonus a-bonus merged commit 7212a15 into a-bonus:main Aug 6, 2025
@a-bonus
Copy link
Copy Markdown
Owner

a-bonus commented Aug 6, 2025

thank you for your contribution!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants