Skip to content

Feature Request: Gmail Filter Management Tools (listFilters, createFilter, deleteFilter) #189

@aaaaaandrew

Description

@aaaaaandrew

Summary

Request to add Gmail filter management capabilities to the Google Workspace MCP server.

Requested Tools

Tool Description
gmail_listFilters List all filters for the authenticated user
gmail_createFilter Create a new filter with criteria and actions
gmail_getFilter Get a specific filter by ID
gmail_deleteFilter Delete a filter by ID

Use Cases

  • Automate inbox organization setup
  • Programmatically manage email routing rules
  • Set up filters for specific projects or workflows
  • Bulk filter management

Technical Reference

Gmail API supports filter management via users.settings.filters resource:
https://developers.google.com/gmail/api/reference/rest/v1/users.settings.filters

OAuth Scope

Requires: https://www.googleapis.com/auth/gmail.settings.basic

Why This Belongs Upstream

Building a separate MCP server for Gmail filters would require either:

  1. Duplicating OAuth authentication (users log in twice)
  2. Sharing tokens between MCP servers (fragile, non-standard)
  3. Building an OAuth proxy (adds complexity)

Since the google-workspace MCP already has Gmail auth, token caching, and refresh logic, adding filter tools there is ~50-100 lines vs ~300-400 lines + auth complexity for a separate server.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions