Skip to content

justpen-integration-mcp logo

justpen-integration-mcp

Gmail + Google APIs integration MCP server for the justpen orchestrator. The read_emails tool retrieves email content or a matching-message count using Gmail service-account delegation and the gmail.readonly scope.

Run the server

Configure Gmail access using the Configuration guide, then start the installed server with stdio:

python -m justpen_integration_mcp

Or start Streamable HTTP on http://127.0.0.1:8932/mcp:

python -m justpen_integration_mcp --transport http

From a development checkout, run make setup once, then prefix either command with uv run. The server validates configuration and makes a read-only Gmail probe before accepting MCP connections.

Tools

  • read_emails: search messages, page through readable bodies, retrieve one result or count all matches.

See Telemetry to export sanitized MCP traces, operational events, and request metrics to an OTLP collector.

Development

  • Getting started: install the development tools and understand the automatic Git-hook gates.
  • Claude Code and Codex: activate shared development rules and the protected-files guard.
  • PR checklist: branch, commits, tests, docs and merge style.
  • Lint & typing: Ruff and strict Pyright rules.
  • Template updates: update the recorded development baseline while preserving application configuration, licensing and history.

License

Proprietary. Part of the justpen toolkit.