get_profile
Retrieve the current user's Gmail profile to access essential details using the Gmail MCP server, enabling streamlined email account management and personalization.
Instructions
Get the current user's Gmail profile
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {},
"type": "object"
}
Implementation Reference
- src/index.ts:1303-1312 (registration)Registration of the 'get_profile' tool, including inline schema (empty input parameters) and handler function that uses handleTool to execute gmail.users.getProfile API call to retrieve the current user's Gmail profile.server.tool("get_profile", "Get the current user's Gmail profile", {}, async () => { return handleTool(config, async (gmail: gmail_v1.Gmail) => { const { data } = await gmail.users.getProfile({ userId: 'me' }) return formatResponse(data) }) } )
- src/index.ts:1306-1311 (handler)The handler function for the get_profile tool, which invokes the shared handleTool utility to authenticate and call the Gmail API's users.getProfile method.async () => { return handleTool(config, async (gmail: gmail_v1.Gmail) => { const { data } = await gmail.users.getProfile({ userId: 'me' }) return formatResponse(data) }) }
- src/index.ts:50-80 (helper)Shared helper function used by all Gmail tools, including get_profile, to handle OAuth2 authentication, Gmail client creation, API call execution, and error handling.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)Helper function to format API responses into MCP-compatible content structure, used by get_profile handler.const formatResponse = (response: any) => ({ content: [{ type: "text", text: JSON.stringify(response) }] })