Personal AI, On Personal Devices
Python
feat: add Gmail IMAP connector with app password auth
krypticmouse1feefd21107d
diff --git a/src/openjarvis/connectors/gmail_imap.py b/src/openjarvis/connectors/gmail_imap.pynew file mode 100644index 00000000..6b498446--- /dev/null+++ b/src/openjarvis/connectors/gmail_imap.py@@ -0,0 +1,244 @@+"""Gmail IMAP connector — reads email via IMAP with app password.++Simpler alternative to the OAuth-based Gmail connector.+Uses Python's built-in imaplib + email modules (no dependencies).++Setup: generate an app password at https://myaccount.google.com/apppasswords+"""++from __future__ import annotations++import email as email_lib+import imaplib+import logging+from datetime import datetime+from email.header import decode_header+from email.utils import parsedate_to_datetime+from typing import Iterator, List, Optional++from openjarvis.connectors._stubs import BaseConnector, Document, SyncStatus+from openjarvis.connectors.oauth import delete_tokens, load_tokens, save_tokens+from openjarvis.core.config import DEFAULT_CONFIG_DIR+from openjarvis.core.registry import ConnectorRegistry+from openjarvis.tools._stubs import ToolSpec++logger = logging.getLogger(__name__)++_DEFAULT_CREDENTIALS_PATH = str(DEFAULT_CONFIG_DIR / "connectors" / "gmail_imap.json")+++def _decode_subject(raw: str) -> str:+ """Decode a possibly-encoded email subject header."""+ if not raw:+ return ""+ decoded_parts = decode_header(raw)+ return "".join(+ part.decode(enc or "utf-8", errors="replace")+ if isinstance(part, bytes)+ else part+ for part, enc in decoded_parts+ )+++def _extract_text_body(msg: email_lib.message.Message) -> str:+ """Extract plain-text body from an email Message object."""+ if msg.is_multipart():+ for part in msg.walk():+ ct = part.get_content_type()+ if ct == "text/plain":+ payload = part.get_payload(decode=True)+ if payload:+ return payload.decode("utf-8", errors="replace")+ # Fallback: try text/html+ for part in msg.walk():+ if part.get_content_type() == "text/html":+ payload = part.get_payload(decode=True)+ if payload:+ return payload.decode("utf-8", errors="replace")+ return ""+ payload = msg.get_payload(decode=True)+ if payload:+ return payload.decode("utf-8", errors="replace")+ return ""+++def _parse_date(msg: email_lib.message.Message) -> datetime:+ """Parse the Date header, falling back to now."""+ date_str = msg.get("Date", "")+ if not date_str:+ return datetime.now()+ try:+ return parsedate_to_datetime(date_str)+ except Exception:+ return datetime.now()++[email protected]("gmail_imap")+class GmailIMAPConnector(BaseConnector):+ """Gmail connector using IMAP + app password.++ No OAuth needed — just an email address and app password.+ """++ connector_id = "gmail_imap"+ display_name = "Gmail (IMAP)"+ auth_type = "oauth" # Reuses credential storage pattern++ def __init__(+ self,+ email_address: str = "",+ app_password: str = "",+ credentials_path: str = "",+ *,+ max_messages: int = 500,+ ) -> None:+ self._email = email_address+ self._password = app_password+ self._credentials_path = credentials_path or _DEFAULT_CREDENTIALS_PATH+ self._max_messages = max_messages+ self._items_synced = 0+ self._items_total = 0++ def _resolve_credentials(self) -> tuple[str, str]:+ """Return (email, password) — direct args take priority."""+ if self._email and self._password:+ return self._email, self._password+ tokens = load_tokens(self._credentials_path)+ if tokens:+ return tokens.get("email", ""), tokens.get("password", "")+ return "", ""++ def is_connected(self) -> bool:+ em, pw = self._resolve_credentials()+ return bool(em and pw)++ def disconnect(self) -> None:+ self._email = ""+ self._password = ""+ delete_tokens(self._credentials_path)++ def auth_url(self) -> str:+ return "https://myaccount.google.com/apppasswords"++ def handle_callback(self, code: str) -> None:+ # code format: "email:password"+ if ":" in code:+ em, pw = code.split(":", 1)+ save_tokens(+ self._credentials_path,+ {"email": em.strip(), "password": pw.strip()},+ )+ else:+ save_tokens(+ self._credentials_path,+ {"email": "", "password": code.strip()},+ )++ def sync(+ self,+ *,+ since: Optional[datetime] = None,+ cursor: Optional[str] = None,+ ) -> Iterator[Document]:+ em, pw = self._resolve_credentials()+ if not em or not pw:+ return++ imap = imaplib.IMAP4_SSL("imap.gmail.com")+ try:+ imap.login(em, pw)+ except imaplib.IMAP4.error as exc:+ logger.error("IMAP login failed: %s", exc)+ return++ imap.select("INBOX", readonly=True)++ # Build search criteria+ if since:+ date_str = since.strftime("%d-%b-%Y")+ _, data = imap.search(None, f"SINCE {date_str}")+ else:+ _, data = imap.search(None, "ALL")++ msg_ids = data[0].split()+ self._items_total = len(msg_ids)++ # Take the most recent N messages+ recent = msg_ids[-self._max_messages :]+ synced = 0++ for mid in recent:+ try:+ _, msg_data = imap.fetch(mid, "(RFC822)")+ raw = msg_data[0][1]+ msg = email_lib.message_from_bytes(raw)+ except Exception:+ continue++ subject = _decode_subject(msg.get("Subject", ""))+ sender = msg.get("From", "")+ to = msg.get("To", "")+ body = _extract_text_body(msg)+ timestamp = _parse_date(msg)+ message_id = msg.get("Message-ID", mid.decode())++ synced += 1+ yield Document(+ doc_id=f"gmail:{message_id}",+ source="gmail",+ doc_type="email",+ content=body,+ title=subject,+ author=sender,+ participants=[a.strip() for a in (to or "").split(",") if a.strip()],+ timestamp=timestamp,+ thread_id=msg.get("In-Reply-To", ""),+ url="https://mail.google.com/mail/u/0/#inbox",+ metadata={+ "message_id": message_id,+ },+ )++ imap.logout()+ self._items_synced = synced++ def sync_status(self) -> SyncStatus:+ return SyncStatus(+ state="idle",+ items_synced=self._items_synced,+ items_total=self._items_total,+ )++ def mcp_tools(self) -> List[ToolSpec]:+ return [+ ToolSpec(+ name="gmail_search_emails",+ description="Search Gmail messages by keyword.",+ parameters={+ "type": "object",+ "properties": {+ "query": {+ "type": "string",+ "description": "Search query",+ },+ },+ "required": ["query"],+ },+ category="communication",+ ),+ ToolSpec(+ name="gmail_list_unread",+ description="List recent unread emails.",+ parameters={+ "type": "object",+ "properties": {+ "max_results": {+ "type": "integer",+ "description": "Max results",+ "default": 10,+ },+ },+ },+ category="communication",+ ),+ ]