feedsheriff

Files (18)

• marketplace.json · .claude-plugin/
• plugin.json · .claude-plugin/
• plugin.json · .cursor-plugin/
• .gitignore
• .mcp.json
• LICENSE
• README.md
• SECURITY.md
• SKILL.md
• banner.png · assets/
• logo.png · assets/
• cleanup.md · commands/
• draft-filter.md · commands/
• review.md · commands/
• status.md · commands/
• undo.md · commands/
• mcp.json
• plugin.json

SKILL.md (first lines)

# FeedSheriff — agent onboarding

FeedSheriff is an inbox cleanup product for Gmail, Outlook, and Zoho Mail. Paid **Solo** or **Multi** plans can connect Claude, ChatGPT, Cursor, VS Code, Codex, and other agents over MCP so they can read the dashboard, write filters, and (if allowed) run cleanups.

Server: `https://feedsheriff.com/mcp` (Streamable HTTP)  
Docs: https://feedsheriff.com/docs/mcp  
Plugin + workflow skills: https://github.com/sarthakguptadev/feedsheriff-mcp  
API keys: https://feedsheriff.com/app/settings?tab=agents (prefix `fs_live_`)

## When this skill applies

Use FeedSheriff when the human wants to:

- Connect an agent to their FeedSheriff account
- See account, mailboxes, dashboard, filters, routines, or live cleanups
- Draft, test, create, update, or delete inbox filters in plain English
- Preview or start a cleanup, triage Review, or undo a sweep

Do **not** invent an API key. Do **not** call `start_cleanup` without a fresh `confirmToken` from `preview_cleanup`, and never before the human confirms the preview counts.

## 1. Credentials

Every MCP call needs auth:

| Method | When to use |
|---|---|
| **OAuth 2.1** (browser) | Claude, ChatGPT, Claude Desktop, VS Code, Codex, Windsurf, Gemini — preferred |
| **API key** `fs_live_…` | Cursor plugin, scripts, or any client that only supports Bearer headers |

### If the human pasted a key in the setup prompt

They said something like:

```text
Set up https://feedsheriff.com/SKILL.md with this FeedSheriff API key: fs_live_…
```

Use that key as `Authorization: Bearer fs_live_…` when adding the MCP server. Do not print the full key back. Do not invent a different key.

### If no key was pasted

Prefer OAuth. Add the MCP server with the client's native install, then complete browser consent. Ask them to approve **read**, **write**, and **cleanup** only if they want the agent to move mail. Cleanup is opt-in and off by default.

If the client cannot do OAuth, tell them to create a key at https://feedsheriff.com/app/settings?tab=agents and wait for them to paste it. Keys are shown once.

Paid Solo or Multi is required. Free accounts cannot connect agents.

## 2. Add the MCP server

Detect which client you are, then use that client's install.

### Claude Code

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

If they gave you a key:

```bash
claude mcp add --transport http feedsheriff-mcp https://feedsheriff.com/mcp --header "Authorization: Bearer fs_live_YOUR_KEY"
```

Then install the plugin (skills + slash commands):

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

Run `/mcp` and finish OAuth if you did not use a key.

### Cursor

Add to MCP settings / `~/.cursor/mcp.json`:

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

With a key, add `"headers": { "Authorization": "Bearer fs_live_YOUR_KEY" }`. Install the GitHub plugin for workflow skills when possible.

### Claude Desktop / Claude.ai

Custom connector URL: `https://feedsheriff.com/mcp` — complete OAuth.

### ChatGPT

Settings → Apps & Connectors → custom MCP connector → `https://feedsheriff.com/mcp` → Auth: OAuth.

### Codex

`~/.codex/config.toml`:

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

Then: `codex mcp login feedsheriff-mcp`

### VS Code

`.vscode/mcp.json`:

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

From sarthakguptadev/feedsheriff-mcp, MIT.

More from sarthakguptadev/feedsheriff-mcp