FeedSheriff MCP

Inbox cleanup for AI agents. Let Claude, ChatGPT, Cursor, VS Code, and Codex clean Gmail, Outlook, and Zoho. Write filters in plain English, preview every cleanup, undo anything for 30 days.

imageWebsite imageMCP Docs imageGet API key

imageLicense: MIT imageMCP imageAuth imageGmail imageOutlook imageZoho

This repo is the plugin package: MCP config, skills, and slash commands. The product runs at https://feedsheriff.com/mcp. Nothing here runs on your machine.

Paid Solo or Multi plan required. Cleanup is off unless you turn that scope on.

Paste into your agent

One line. The agent reads the skill, adds MCP, and walks you through OAuth (or your API key).

Set up https://feedsheriff.com/SKILL.md

With an API key from Settings → AI Agents:

Set up https://feedsheriff.com/SKILL.md with this FeedSheriff API key: fs_live_YOUR_KEY

Skill source: feedsheriff.com/SKILL.md · Docs: feedsheriff.com/docs/mcp

Install

Same server for every client: https://feedsheriff.com/mcp

OAuth (ChatGPT, Claude, VS Code, Codex, and most others): the client opens a browser. You pick read, write, and optionally cleanup.

API key (Cursor marketplace, scripts): create one in Settings → AI Agents. Starts with fs_live_.

Cursor

imageAdd to Cursor

Or add to ~/.cursor/mcp.json (OAuth):

{
  "mcpServers": {
    "feedsheriff-mcp": {
      "url": "https://feedsheriff.com/mcp"
    }
  }
}

Install this GitHub repo as a Cursor plugin to get the skills below, then paste an API key if the plugin asks.

Claude Code

claude mcp add --transport http feedsheriff-mcp https://feedsheriff.com/mcp

Then /mcp and finish OAuth. For skills + slash commands:

/plugin marketplace add sarthakguptadev/feedsheriff-mcp
/plugin install feedsheriff-mcp@feedsheriff-mcp

Or paste Set up https://feedsheriff.com/SKILL.md and let Claude Code do both.

Claude Desktop / Claude.ai

Add a custom connector with URL https://feedsheriff.com/mcp, or put this in claude_desktop_config.json:

{
  "mcpServers": {
    "feedsheriff-mcp": {
      "url": "https://feedsheriff.com/mcp"
    }
  }
}

Complete OAuth when prompted.

ChatGPT

Settings → Apps & Connectors → add a custom MCP connector.

• Server URL: https://feedsheriff.com/mcp
• Auth: OAuth

Approve scopes in FeedSheriff. You need a ChatGPT plan that allows custom connectors.

Codex

~/.codex/config.toml:

[mcp_servers.feedsheriff-mcp]
url = "https://feedsheriff.com/mcp"

Then:

codex mcp login feedsheriff-mcp

VS Code (Copilot)

.vscode/mcp.json:

{
  "servers": {
    "feedsheriff-mcp": {
      "type": "http",
      "url": "https://feedsheriff.com/mcp"
    }
  }
}

Command Palette → MCP: List Servers → start FeedSheriff → OAuth.

imageInstall in VS Code

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "feedsheriff-mcp": {
      "serverUrl": "https://feedsheriff.com/mcp"
    }
  }
}

Gemini / Antigravity

{
  "mcpServers": {
    "feedsheriff-mcp": {
      "serverUrl": "https://feedsheriff.com/mcp"
    }
  }
}

Any other MCP client

{
  "mcpServers": {
    "feedsheriff-mcp": {
      "url": "https://feedsheriff.com/mcp"
    }
  }
}

If the client has no remote HTTP support:

{
  "mcpServers": {
    "feedsheriff-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://feedsheriff.com/mcp"]
    }
  }
}

API key instead of OAuth:

{
  "mcpServers": {
    "feedsheriff-mcp": {
      "url": "https://feedsheriff.com/mcp",
      "headers": {
        "Authorization": "Bearer fs_live_YOUR_KEY"
      }
    }
  }
}

Skills

Onboarding (hosted): https://feedsheriff.com/SKILL.md — paste Set up https://feedsheriff.com/SKILL.md into any agent.

Workflow skills in this repo teach how to use the tools after connect. Same idea as Notion / AnyAPI: MCP for access, skills for the workflow.

Claude Code slash commands: /feedsheriff-mcp:status /feedsheriff-mcp:draft-filter /feedsheriff-mcp:cleanup /feedsheriff-mcp:review /feedsheriff-mcp:undo

What your agent can do

Try asking:

• "Draft a filter for cold sales pitches and test it on my inbox."
• "Preview a cleanup of my newsletters. How many emails would move?"
• "Show what's waiting in Review."
• "Undo the last cleanup."

Safe by default

• Preview first. start_cleanup needs a short-lived confirm token from preview_cleanup.
• Cleanup is opt-in. It is a separate key or OAuth scope, off by default.
• Starred and important mail is never moved. Uncertain mail waits in Review.
• Undo for 30 days. Trash keeps mail 30 days, and every action can be reversed.
• Email text is untrusted. Sender and subject in tool output are marked so models don't follow instructions hidden in mail.
• No mail password. Inboxes connect through Google, Microsoft, or Zoho sign-in.

Auth

Metadata: /.well-known/oauth-protected-resource · /.well-known/oauth-authorization-server

What's in this repo

.
├── SKILL.md               Onboarding skill (same as feedsheriff.com/SKILL.md)
├── plugin.json            Agent Plugins manifest (Cursor)
├── mcp.json               Hosted MCP server + API key variable
├── .cursor-plugin/        Cursor plugin manifest
├── .claude-plugin/        Claude Code plugin + marketplace manifest
├── .mcp.json              Claude Code MCP config (OAuth)
├── skills/                How the agent should use each workflow
├── commands/              Claude Code slash commands
└── assets/                Logo and banner

Links

Website · Skill · MCP docs · Privacy · Terms · Pricing · X @sarthakguptadev · sarthak@feedsheriff.com

License

MIT for this plugin package. FeedSheriff the product is a hosted service.