Google Workspace MCP Server - Control Gmail, Calendar, Docs, Sheets, Slides, Chat, Forms & Drive

Instructions

Retrieves messages from a Google Chat space.

Returns:
    str: Formatted messages from the specified space.

Implementation Reference

• gchat/chat_tools.py:67-112 (handler)

  The core handler function that retrieves messages from a specified Google Chat space. It fetches space information, lists recent messages using the Google Chat API, formats them with sender, time, content, and message ID, and returns a formatted string.

  async def get_messages(
      service,
      user_google_email: str,
      space_id: str,
      page_size: int = 50,
      order_by: str = "createTime desc"
  ) -> str:
      """
      Retrieves messages from a Google Chat space.
  
      Returns:
          str: Formatted messages from the specified space.
      """
      logger.info(f"[get_messages] Space ID: '{space_id}' for user '{user_google_email}'")
  
      # Get space info first
      space_info = await asyncio.to_thread(
          service.spaces().get(name=space_id).execute
      )
      space_name = space_info.get('displayName', 'Unknown Space')
  
      # Get messages
      response = await asyncio.to_thread(
          service.spaces().messages().list(
              parent=space_id,
              pageSize=page_size,
              orderBy=order_by
          ).execute
      )
  
      messages = response.get('messages', [])
      if not messages:
          return f"No messages found in space '{space_name}' (ID: {space_id})."
  
      output = [f"Messages from '{space_name}' (ID: {space_id}):\n"]
      for msg in messages:
          sender = msg.get('sender', {}).get('displayName', 'Unknown Sender')
          create_time = msg.get('createTime', 'Unknown Time')
          text_content = msg.get('text', 'No text content')
          msg_name = msg.get('name', '')
  
          output.append(f"[{create_time}] {sender}:")
          output.append(f"  {text_content}")
          output.append(f"  (Message ID: {msg_name})\n")
  
      return "\n".join(output)

• gchat/chat_tools.py:64-64 (registration)

  Registers the 'get_messages' tool with the MCP server using the @server.tool() decorator.

  @server.tool()

• gchat/chat_tools.py:64-66 (registration)

  Decorator stack that registers the tool, requires Google Chat read permissions, and handles HTTP errors specifically for 'get_messages'.

  @server.tool()
  @require_google_service("chat", "chat_read")
  @handle_http_errors("get_messages", service_type="chat")