authenticate
Generate a Google authentication URL to connect the Google Tasks MCP Server with your Google account for task management through Claude.
Instructions
Get URL to authenticate with Google Tasks
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/index.ts:56-135 (handler)The handler function for the 'authenticate' tool. It sets up a temporary HTTP server on port 3000 to handle the OAuth callback, generates the Google authorization URL, starts the server, and returns the URL with instructions to the user.
async () => { // Make sure any previous server is closed if (authServer) { try { authServer.close(); } catch (error) { console.error('Error closing existing auth server:', error); } authServer = null; } // Create the temporary HTTP server for OAuth callback authServer = http.createServer(async (req, res) => { try { // Parse the URL to get the authorization code const queryParams = url.parse(req.url || '', true).query; const code = queryParams.code; if (code) { console.error('✅ Authorization code received'); // Send success response with the code res.writeHead(200, { 'Content-Type': 'text/html' }); res.end(` <h1>Authorization Code Received</h1> <p>Please copy this code and use it with the 'set-auth-code' tool in Claude:</p> <div style="padding: 10px; background-color: #f0f0f0; border: 1px solid #ccc; margin: 20px 0;"> <code>${code}</code> </div> <p>You can close this window after copying the code.</p> `); // Close the server after a short delay setTimeout(() => { if (authServer) { authServer.close(); authServer = null; } }, 60000); // Keep the server alive for 1 minute } else { res.writeHead(400, { 'Content-Type': 'text/html' }); res.end(` <h1>Authentication Failed</h1> <p>No authorization code received.</p> <p>Please try again.</p> `); } } catch (error) { console.error('Error during authentication:', error); res.writeHead(500, { 'Content-Type': 'text/html' }); res.end(` <h1>Authentication Error</h1> <p>${error instanceof Error ? error.message : String(error)}</p> `); } }); // Start the server authServer.listen(REDIRECT_PORT, () => { console.error(`Temporary authentication server running at http://localhost:${REDIRECT_PORT}/`); console.error('Waiting for authentication...'); }); // Generate the auth URL const authUrl = oauth2Client.generateAuthUrl({ access_type: 'offline', scope: SCOPES, // Force approval prompt to always get a refresh token prompt: 'consent' }); return { content: [ { type: "text", text: `Please visit this URL to authenticate with Google Tasks:\n\n${authUrl}\n\nAfter authenticating, you'll receive a code. Use the 'set-auth-code' tool with that code.`, }, ], }; } - src/index.ts:52-136 (registration)Registration of the 'authenticate' tool via server.tool call. It has no input parameters (empty schema) and provides a description.
server.tool( "authenticate", "Get URL to authenticate with Google Tasks", {}, async () => { // Make sure any previous server is closed if (authServer) { try { authServer.close(); } catch (error) { console.error('Error closing existing auth server:', error); } authServer = null; } // Create the temporary HTTP server for OAuth callback authServer = http.createServer(async (req, res) => { try { // Parse the URL to get the authorization code const queryParams = url.parse(req.url || '', true).query; const code = queryParams.code; if (code) { console.error('✅ Authorization code received'); // Send success response with the code res.writeHead(200, { 'Content-Type': 'text/html' }); res.end(` <h1>Authorization Code Received</h1> <p>Please copy this code and use it with the 'set-auth-code' tool in Claude:</p> <div style="padding: 10px; background-color: #f0f0f0; border: 1px solid #ccc; margin: 20px 0;"> <code>${code}</code> </div> <p>You can close this window after copying the code.</p> `); // Close the server after a short delay setTimeout(() => { if (authServer) { authServer.close(); authServer = null; } }, 60000); // Keep the server alive for 1 minute } else { res.writeHead(400, { 'Content-Type': 'text/html' }); res.end(` <h1>Authentication Failed</h1> <p>No authorization code received.</p> <p>Please try again.</p> `); } } catch (error) { console.error('Error during authentication:', error); res.writeHead(500, { 'Content-Type': 'text/html' }); res.end(` <h1>Authentication Error</h1> <p>${error instanceof Error ? error.message : String(error)}</p> `); } }); // Start the server authServer.listen(REDIRECT_PORT, () => { console.error(`Temporary authentication server running at http://localhost:${REDIRECT_PORT}/`); console.error('Waiting for authentication...'); }); // Generate the auth URL const authUrl = oauth2Client.generateAuthUrl({ access_type: 'offline', scope: SCOPES, // Force approval prompt to always get a refresh token prompt: 'consent' }); return { content: [ { type: "text", text: `Please visit this URL to authenticate with Google Tasks:\n\n${authUrl}\n\nAfter authenticating, you'll receive a code. Use the 'set-auth-code' tool with that code.`, }, ], }; } ); - src/index.ts:47-49 (helper)Helper function used by multiple tools to check if authentication credentials are set before allowing access to Google Tasks API.
function isAuthenticated() { return credentials !== null; } - src/index.ts:55-55 (schema)Empty input schema for the 'authenticate' tool, indicating it takes no parameters.
{}, - src/index.ts:46-50 (helper)Comment and helper function declaration for authentication status check, used extensively in other tools.
// Helper function to check if authenticated function isAuthenticated() { return credentials !== null; }