get_pop
Retrieve POP settings for email accounts to configure incoming mail servers with Gmail MCP. Simplify email setup and management for seamless server integration.
Instructions
Gets POP settings
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/index.ts:864-873 (handler)The inline handler and registration for the 'get_pop' tool. It calls the Gmail API to get POP settings via the shared handleTool function, which handles authentication and error handling.server.tool("get_pop", "Gets POP settings", {}, async () => { return handleTool(config, async (gmail: gmail_v1.Gmail) => { const { data } = await gmail.users.settings.getPop({ userId: 'me' }) return formatResponse(data) }) } )
- src/index.ts:864-873 (registration)Registration of the 'get_pop' tool using McpServer.tool() method, including empty schema (no parameters) and the handler function.server.tool("get_pop", "Gets POP settings", {}, async () => { return handleTool(config, async (gmail: gmail_v1.Gmail) => { const { data } = await gmail.users.settings.getPop({ userId: 'me' }) return formatResponse(data) }) } )
- src/index.ts:50-80 (helper)Shared helper function handleTool used by get_pop (and other tools) to handle OAuth2 authentication, Gmail client creation, API call execution, and error handling including auth-specific errors.const handleTool = async (queryConfig: Record<string, any> | undefined, apiCall: (gmail: gmail_v1.Gmail) => Promise<any>) => { try { const oauth2Client = queryConfig ? createOAuth2Client(queryConfig) : defaultOAuth2Client if (!oauth2Client) throw new Error('OAuth2 client could not be created, please check your credentials') const credentialsAreValid = await validateCredentials(oauth2Client) if (!credentialsAreValid) throw new Error('OAuth2 credentials are invalid, please re-authenticate') const gmailClient = queryConfig ? google.gmail({ version: 'v1', auth: oauth2Client }) : defaultGmailClient if (!gmailClient) throw new Error('Gmail client could not be created, please check your credentials') const result = await apiCall(gmailClient) return result } catch (error: any) { // Check for specific authentication errors if ( error.message?.includes("invalid_grant") || error.message?.includes("refresh_token") || error.message?.includes("invalid_client") || error.message?.includes("unauthorized_client") || error.code === 401 || error.code === 403 ) { return formatResponse({ error: `Authentication failed: ${error.message}. Please re-authenticate by running: npx @shinzolabs/gmail-mcp auth`, }); } return formatResponse({ error: `Tool execution failed: ${error.message}` }); } }
- src/index.ts:48-48 (helper)Shared helper to format API responses into MCP content format.const formatResponse = (response: any) => ({ content: [{ type: "text", text: JSON.stringify(response) }] })