Skip to content

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

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.

Activity

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

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