inboxfewer

command module

v0.0.23 Latest Latest Go to latest Published: Nov 3, 2025 License: BSD-3-Clause Imports: 1 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/teemow/inboxfewer

Links

Open Source Insights

README ¶

NAME

inboxfewer - Archive Gmail threads for closed GitHub issues and provide MCP server for AI assistants

SYNOPSIS

inboxfewer [command] [options]
inboxfewer cleanup [--account ACCOUNT] [--debug]
inboxfewer serve [--transport TYPE] [--http-addr ADDR] [--yolo] [--debug]

DESCRIPTION

inboxfewer is a tool that archives Gmail threads related to closed GitHub issues and pull requests. It can run as a standalone CLI tool or as a Model Context Protocol (MCP) server, providing AI assistants with programmatic access to Gmail, Google Docs, Google Drive, Google Calendar, Google Meet, and Google Tasks.

INSTALLATION

Download the latest release for your platform:

# Linux (amd64)
curl -L https://github.com/teemow/inboxfewer/releases/latest/download/inboxfewer_linux_amd64.tar.gz | tar xz

# Linux (arm64)
curl -L https://github.com/teemow/inboxfewer/releases/latest/download/inboxfewer_linux_arm64.tar.gz | tar xz

# macOS (amd64)
curl -L https://github.com/teemow/inboxfewer/releases/latest/download/inboxfewer_darwin_amd64.tar.gz | tar xz

# macOS (arm64)
curl -L https://github.com/teemow/inboxfewer/releases/latest/download/inboxfewer_darwin_arm64.tar.gz | tar xz

# Install to PATH
sudo mv inboxfewer /usr/local/bin/

Or install from source:

go install github.com/teemow/inboxfewer@latest

COMMANDS

cleanup

Archive Gmail threads related to closed GitHub issues and pull requests.

inboxfewer cleanup [--account ACCOUNT]

serve

Start the MCP server to provide tools for AI assistants.

inboxfewer serve [--transport TYPE] [--http-addr ADDR] [--yolo]

Transport Types:

stdio: Standard input/output (default, for desktop apps)
sse: Server-Sent Events (HTTP server on --http-addr)
streamable-http: HTTP streaming (HTTP server on --http-addr)

version

Display version information.

inboxfewer version

generate-docs

Generate markdown documentation for all MCP tools.

inboxfewer generate-docs           # Output to stdout
inboxfewer generate-docs -o FILE   # Output to file

OPTIONS

--account ACCOUNT      Google account name to use (default: "default")
--debug                Enable debug logging
--transport TYPE       MCP transport: stdio, sse, streamable-http (default: stdio)
--http-addr ADDR       HTTP server address for sse/http transports (default: :8080)
--yolo                 Enable write operations in MCP server (default: read-only)

CONFIGURATION

GitHub Token

Create ~/keys/github-inboxfewer.token with:

<github-username> <github-personal-access-token>

Google OAuth

On first run, authenticate with Google services. OAuth tokens are cached at:

Linux/Unix: ~/.cache/inboxfewer/google-{account}.token
macOS: ~/Library/Caches/inboxfewer/google-{account}.token
Windows: %TEMP%/inboxfewer/google-{account}.token

Multi-Account Support

Manage multiple Google accounts using the --account flag:

inboxfewer cleanup --account work
inboxfewer cleanup --account personal

See docs/configuration.md for details.

EXAMPLES

Archive Gmail threads for closed issues:

inboxfewer cleanup

Start MCP server for Claude Desktop:

inboxfewer serve

Start MCP server with HTTP transport:

inboxfewer serve --transport sse --http-addr :8080

Enable all write operations:

inboxfewer serve --yolo

MCP SERVER

The MCP server provides 66 tools for managing Gmail, Google Docs, Drive, Calendar, Meet, and Tasks. By default, the server operates in read-only mode for safety. Use --yolo to enable write operations.

Key Capabilities:

Gmail: List, search, archive, send emails, manage filters
Google Docs: Retrieve document content in markdown or text
Google Drive: Upload, download, organize, share files
Google Calendar: Create events, check availability, schedule meetings
Google Meet: Access recordings, transcripts, and notes
Google Tasks: Create and manage task lists

See docs/tools.md for the complete tool reference (auto-generated from code).

FILES

~/keys/github-inboxfewer.token           GitHub credentials
~/.cache/inboxfewer/google-*.token       Google OAuth tokens (Linux/Unix)
~/Library/Caches/inboxfewer/google-*.token   Google OAuth tokens (macOS)
%TEMP%/inboxfewer/google-*.token         Google OAuth tokens (Windows)

AUTHORS

Original concept by Brad Fitzpatrick. MCP server integration by @teemow.

LICENSE

See LICENSE file for details.

BUGS

Report bugs at: https://github.com/teemow/inboxfewer/issues

Documentation ¶

There is no documentation for this package.

Source Files ¶

View all Source files

main.go

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd Package cmd implements the command-line interface for inboxfewer.	Package cmd implements the command-line interface for inboxfewer.
internal
calendar Package calendar provides a client for interacting with the Google Calendar API.	Package calendar provides a client for interacting with the Google Calendar API.
docs Package docs provides functionality for interacting with Google Docs API.	Package docs provides functionality for interacting with Google Docs API.
drive Package drive provides a client for interacting with the Google Drive API.	Package drive provides a client for interacting with the Google Drive API.
github Package github provides types and utilities for interacting with GitHub issues and pull requests.	Package github provides types and utilities for interacting with GitHub issues and pull requests.
gmail Package gmail provides a client for interacting with the Gmail API.	Package gmail provides a client for interacting with the Gmail API.
google Package google provides shared OAuth2 authentication for Google services.	Package google provides shared OAuth2 authentication for Google services.
meet Package meet provides a client for the Google Meet API v2.	Package meet provides a client for the Google Meet API v2.
server Package server provides the MCP (Model Context Protocol) server context.	Package server provides the MCP (Model Context Protocol) server context.
tasks Package tasks provides a client for managing Google Tasks.	Package tasks provides a client for managing Google Tasks.
tools/batch Package batch provides common utilities for batch operations across all MCP tools.	Package batch provides common utilities for batch operations across all MCP tools.
tools/calendar_tools Package calendar_tools provides MCP (Model Context Protocol) tools for Google Calendar operations.	Package calendar_tools provides MCP (Model Context Protocol) tools for Google Calendar operations.
tools/docs_tools Package docs_tools provides MCP tools for interacting with Google Docs.	Package docs_tools provides MCP tools for interacting with Google Docs.
tools/drive_tools Package drive_tools provides MCP (Model Context Protocol) tools for Google Drive operations.	Package drive_tools provides MCP (Model Context Protocol) tools for Google Drive operations.
tools/gmail_tools Package gmail_tools provides MCP (Model Context Protocol) tools for interacting with Gmail.	Package gmail_tools provides MCP (Model Context Protocol) tools for interacting with Gmail.
tools/google_tools Package google_tools provides MCP tools for Google OAuth authentication.	Package google_tools provides MCP tools for Google OAuth authentication.
tools/meet_tools Package meet_tools provides MCP tools for interacting with the Google Meet API v2.	Package meet_tools provides MCP tools for interacting with the Google Meet API v2.
tools/tasks_tools Package tasks_tools provides MCP tools for managing Google Tasks.	Package tasks_tools provides MCP tools for managing Google Tasks.