Google Contacts Initial Release #17638

d0rN834 · 2025-03-07T14:12:46Z

Description

Manage your Google Contacts directly from Raycast with complete integration, including AI capabilities.

Core Features

🔍 Search contacts by name, email, or phone number
👁️ View detailed contact information
⭐ Mark contacts as favorites for quick access
➕ Create new contacts with comprehensive details
✏️ Edit existing contacts (all fields supported)
🗑️ Delete contacts
🔄 Sync with Google Contacts API

Screencast

See Screenshots. Won't share personal data.

Checklist

I read the extension guidelines
I read the documentation about publishing
I ran npm run build and tested this distribution build in Raycast
I checked that files in the assets folder are used by the extension itself
I checked that assets used in the README are located outside the metadata folder if they were not generated with our metadata tool

Google Contacts Initial Release

greptile-apps

PR Summary

This PR adds a comprehensive Google Contacts extension for Raycast with contact management and AI capabilities. Here are the key points to address:

The CHANGELOG.md contains incorrect entries for Google Tasks - it should be replaced with a single "Initial Version" entry ending with {PR_MERGE_DATE}
The README.md has incorrect store/GitHub links pointing to Microsoft Teams instead of Google Contacts and contains a double period in the description
Since there are view commands in package.json, a metadata folder with screenshots should be added per Raycast guidelines
The tools section in package.json needs to include ai with evals as required by Raycast's AI extension guidelines
The launchCommand in create-contact.tsx should be wrapped in a try-catch block per Raycast best practices

The extension implementation itself appears solid with comprehensive features and good error handling, but these documentation and configuration issues should be addressed before merging.

_{💡 (2/5) Greptile learns from your feedback when you react with 👍/👎!}

_{18 file(s) reviewed, 43 comment(s)}
_{Edit PR Review Bot Settings | Greptile}

greptile-apps · 2025-03-07T14:14:24Z

google-contacts/package.json

+          "query": "John Smith"
+        },
+        {
+          "query": "acme corporation",
+          "limit": 3
+        }
+      ],
+      "arguments": [
+        {
+          "name": "query",
+          "title": "Search Query",
+          "required": true,
+          "description": "The search term to look for in contacts (name, email, company, etc.)"
+        },
+        {
+          "name": "limit",
+          "title": "Result Limit",
+          "required": false,
+          "description": "Maximum number of contacts to return (default: 5)"
+        }
+      ]
+    },
+    {
+      "path": "./src/tools/create-contact",
+      "name": "create-contact",
+      "title": "Create Google Contact",
+      "description": "Create a new contact in your Google Contacts.",
+      "examples": [
+        {
+          "firstName": "John",
+          "lastName": "Smith",
+          "email": "[email protected]",
+          "phone": "+1 555-123-4567"
+        },
+        {
+          "firstName": "Jane",
+          "lastName": "Doe",
+          "company": "Acme Corporation",
+          "jobTitle": "Marketing Manager",
+          "email": "[email protected]"
+        }
+      ],
+      "arguments": [
+        {
+          "name": "firstName",
+          "title": "First Name",
+          "required": true,
+          "description": "The contact's first name"
+        },
+        {
+          "name": "lastName",
+          "title": "Last Name",
+          "required": false,
+          "description": "The contact's last name"
+        },
+        {
+          "name": "email",
+          "title": "Email",
+          "required": false,
+          "description": "The contact's email address"
+        },
+        {
+          "name": "phone",
+          "title": "Phone",
+          "required": false,
+          "description": "The contact's phone number"
+        },
+        {
+          "name": "company",
+          "title": "Company",
+          "required": false,
+          "description": "The contact's company or organization"
+        },
+        {
+          "name": "jobTitle",
+          "title": "Job Title",
+          "required": false,
+          "description": "The contact's job title or position"
+        },
+        {
+          "name": "address",
+          "title": "Address",
+          "required": false,
+          "description": "The contact's physical address"
+        },
+        {
+          "name": "birthday",
+          "title": "Birthday",
+          "required": false,
+          "description": "The contact's birthday in DD.MM.YYYY format"
+        },
+        {
+          "name": "notes",
+          "title": "Notes",
+          "required": false,
+          "description": "Additional notes about the contact"
+        }
+      ]
+    }
+  ],


logic: AI tools are defined but missing required 'ai' field with 'evals'. Please add evals to test the AI functionality. See: https://developers.raycast.com/ai/write-evals-for-your-ai-extension

greptile-apps · 2025-03-07T14:14:24Z

google-contacts/package.json

+      "name": "view-contacts",
+      "title": "List Contacts",
+      "description": "View and manage your Google Contacts",
+      "mode": "view"
+    },
+    {
+      "name": "create-contact",
+      "title": "Create Contact",
+      "description": "Create a new Google Contact",
+      "mode": "view"
+    }


style: Consider adding 'subtitle' field to commands to show 'Google Contacts' as service name for better context

greptile-apps · 2025-03-07T14:15:13Z

google-contacts/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Google Tasks Changelog


logic: This should be 'Google Contacts Changelog' instead of 'Google Tasks Changelog' since this is for the Google Contacts extension

Suggested change

# Google Tasks Changelog

# Google Contacts Changelog

greptile-apps · 2025-03-07T14:15:14Z

google-contacts/CHANGELOG.md

+## [Sort tasks by due date] - 2023-07-23
+
+## [Update] - 2023-05-12
+
+- Increase the maximum tasks from 20 to 100.
+- Modify the filtering logic. This will now display up to 100 open or completed tasks.


logic: These entries appear to be for Google Tasks and should be removed since this is a new Google Contacts extension

greptile-apps · 2025-03-07T14:15:14Z

google-contacts/CHANGELOG.md

+## [Initial Version] - 2022-09-16
+
+Initial version code


syntax: For a new extension, there should be a single entry like:

Suggested change

## [Initial Version] - 2022-09-16

Initial version code

## [Initial Version] {PR_MERGE_DATE}

- Initial version of Google Contacts extension

greptile-apps · 2025-03-07T14:22:43Z

google-contacts/src/utils.tsx

+  // Format a birthday from a ContactBirthday object
+  export function formatBirthday(birthday: ContactBirthday): string {
+    // If there's a text representation, use that
+    if (birthday.text) {
+      return birthday.text;
+    }
+
+    // If there's date information, format it
+    if (birthday.date) {
+      const { year, month, day } = birthday.date;
+
+      // Format: dd.MM.yyyy or dd.MM depending on if year is available
+      if (month && day) {
+        const monthStr = month.toString().padStart(2, '0');
+        const dayStr = day.toString().padStart(2, '0');
+
+        if (year) {
+          return `${dayStr}.${monthStr}.${year}`;
+        } else {
+          return `${dayStr}.${monthStr}`;
+        }
+      }
+    }
+
+    return "Unknown";
+  }
+
+  // Get birthday info from a contact
+  export function getBirthdayInfo(contact: Contact): string | undefined {
+    if (!contact.birthdays || contact.birthdays.length === 0) {
+      return undefined;
+    }
+
+    // Try to find the primary birthday if there are multiple
+    const primaryBirthday = contact.birthdays.find(birthday => birthday.metadata?.primary);
+
+    // If primary birthday exists, use it, otherwise use the first birthday
+    const birthdayToUse = primaryBirthday || contact.birthdays[0];
+
+    return formatBirthday(birthdayToUse);
+  }


syntax: formatBirthday and getBirthdayInfo functions are incorrectly indented - they should be at the root level

Suggested change

// Format a birthday from a ContactBirthday object

export function formatBirthday(birthday: ContactBirthday): string {

// If there's a text representation, use that

if (birthday.text) {

return birthday.text;

}

// If there's date information, format it

if (birthday.date) {

const { year, month, day } = birthday.date;

// Format: dd.MM.yyyy or dd.MM depending on if year is available

if (month && day) {

const monthStr = month.toString().padStart(2, '0');

const dayStr = day.toString().padStart(2, '0');

if (year) {

return `${dayStr}.${monthStr}.${year}`;

} else {

return `${dayStr}.${monthStr}`;

}

}

}

return "Unknown";

}

// Get birthday info from a contact

export function getBirthdayInfo(contact: Contact): string | undefined {

if (!contact.birthdays || contact.birthdays.length === 0) {

return undefined;

}

// Try to find the primary birthday if there are multiple

const primaryBirthday = contact.birthdays.find(birthday => birthday.metadata?.primary);

// If primary birthday exists, use it, otherwise use the first birthday

const birthdayToUse = primaryBirthday || contact.birthdays[0];

return formatBirthday(birthdayToUse);

}

// Format a birthday from a ContactBirthday object

export function formatBirthday(birthday: ContactBirthday): string {

// If there's a text representation, use that

if (birthday.text) {

return birthday.text;

}

// If there's date information, format it

if (birthday.date) {

const { year, month, day } = birthday.date;

// Format: dd.MM.yyyy or dd.MM depending on if year is available

if (month && day) {

const monthStr = month.toString().padStart(2, '0');

const dayStr = day.toString().padStart(2, '0');

if (year) {

return `${dayStr}.${monthStr}.${year}`;

} else {

return `${dayStr}.${monthStr}`;

}

}

}

return "Unknown";

}

// Get birthday info from a contact

export function getBirthdayInfo(contact: Contact): string | undefined {

if (!contact.birthdays || contact.birthdays.length === 0) {

return undefined;

}

// Try to find the primary birthday if there are multiple

const primaryBirthday = contact.birthdays.find(birthday => birthday.metadata?.primary);

// If primary birthday exists, use it, otherwise use the first birthday

const birthdayToUse = primaryBirthday || contact.birthdays[0];

return formatBirthday(birthdayToUse);

}

greptile-apps · 2025-03-07T14:23:57Z

google-contacts/src/view-contacts.tsx

+// Cache keys
+const CONTACTS_CACHE_KEY = "google_contacts_cached_data";
+const CACHE_TIMESTAMP_KEY = "google_contacts_cache_timestamp";
+const CACHE_EXPIRY_TIME = 60 + 24 * 60 * 1000; // 1 Day in milliseconds


logic: Cache expiry time calculation is incorrect - should be 24 * 60 * 60 * 1000 for 1 day in milliseconds

Suggested change

const CACHE_EXPIRY_TIME = 60 + 24 * 60 * 1000; // 1 Day in milliseconds

const CACHE_EXPIRY_TIME = 24 * 60 * 60 * 1000; // 1 Day in milliseconds

greptile-apps · 2025-03-07T14:23:58Z

google-contacts/src/view-contacts.tsx

+        await google.authorize();
+        const allContacts = await fetchContacts(1000);


style: google.authorize() should be wrapped in try/catch to handle auth failures gracefully

greptile-apps · 2025-03-07T14:23:58Z

google-contacts/src/view-contacts.tsx

+        // Only show error toast if we don't have cached contacts to show
+        if (contacts.length === 0) {
+          setIsLoading(false);
+          showToast({ style: Toast.Style.Failure, title: String(error) });


style: Could be simplified using showFailureToast from @raycast/utils

Suggested change

showToast({ style: Toast.Style.Failure, title: String(error) });

showFailureToast(String(error));

greptile-apps · 2025-03-07T14:23:59Z

google-contacts/src/view-contacts.tsx

+  if (isLoading && contacts.length === 0) {
+    return <Detail isLoading={true} markdown="Loading contacts..." />;
+  }


style: Consider using List with isLoading prop instead of Detail to avoid empty state flicker

Suggested change

if (isLoading && contacts.length === 0) {

return <Detail isLoading={true} markdown="Loading contacts..." />;

}

if (isLoading && contacts.length === 0) {

return <ContactsView initialContacts={[]} filter={Filter.All} isLoading={true} />;

}

raycastbot · 2025-03-13T09:43:05Z

Congratulations on your new Raycast extension! 🚀

Due to our current reduced availability, the initial review may take up to 10-15 business days

Once the PR is approved and merged, the extension will be available on our Store.

d0rN834 · 2025-03-18T16:32:55Z

I'm sorry, but I cant resolve the issues. See terminal output attached:

andreaselia · 2025-04-26T21:57:03Z

Hey @d0rN834 👋

You can run npx ray lint --fix to hopefully automatically resolve your lint issues here.

Let me know if you run into any further issues.

d0rN834 added 2 commits March 7, 2025 15:04

Add files via upload

86244f0

Google Contacts Initial Release

e026ea5

Google Contacts Initial Release

greptile-apps bot reviewed Mar 7, 2025

View reviewed changes

d0rN834 and others added 4 commits March 8, 2025 06:06

Update CHANGELOG.md

f90dc64

Update README.md

55a2d46

Update README.md

b00fe87

Moved to right folder

97a5451

raycastbot added the new extension Label for PRs with new extensions label Mar 13, 2025

pernielsentikaer added AI Extension and removed new extension Label for PRs with new extensions labels Mar 13, 2025

Prettier Update

7821beb

raycastbot added the new extension Label for PRs with new extensions label Mar 14, 2025

d0rN834 added 4 commits March 18, 2025 17:13

Resolved Linting issues

bf14480

Delete extensions/google-contacts/assets directory

2848829

Delete extensions/google-contacts/metadata directory

fbe95cc

Resolved Linting issues

73c6484

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Google Contacts Initial Release #17638

Google Contacts Initial Release #17638

d0rN834 commented Mar 7, 2025

greptile-apps bot left a comment

greptile-apps bot Mar 7, 2025

greptile-apps bot Mar 7, 2025

greptile-apps bot Mar 7, 2025

greptile-apps bot Mar 7, 2025

greptile-apps bot Mar 7, 2025

greptile-apps bot Mar 7, 2025

greptile-apps bot Mar 7, 2025

greptile-apps bot Mar 7, 2025

greptile-apps bot Mar 7, 2025

greptile-apps bot Mar 7, 2025

raycastbot commented Mar 13, 2025

d0rN834 commented Mar 18, 2025

andreaselia commented Apr 26, 2025

	const CACHE_EXPIRY_TIME = 60 + 24 * 60 * 1000; // 1 Day in milliseconds
	const CACHE_EXPIRY_TIME = 24 * 60 * 60 * 1000; // 1 Day in milliseconds

		await google.authorize();
		const allContacts = await fetchContacts(1000);

	showToast({ style: Toast.Style.Failure, title: String(error) });
	showFailureToast(String(error));

Google Contacts Initial Release #17638

Are you sure you want to change the base?

Google Contacts Initial Release #17638

Conversation

d0rN834 commented Mar 7, 2025

Description

Core Features

Screencast

Checklist

greptile-apps bot left a comment

Choose a reason for hiding this comment

PR Summary

greptile-apps bot Mar 7, 2025

Choose a reason for hiding this comment

greptile-apps bot Mar 7, 2025

Choose a reason for hiding this comment

greptile-apps bot Mar 7, 2025

Choose a reason for hiding this comment

greptile-apps bot Mar 7, 2025

Choose a reason for hiding this comment

greptile-apps bot Mar 7, 2025

Choose a reason for hiding this comment

greptile-apps bot Mar 7, 2025

Choose a reason for hiding this comment

greptile-apps bot Mar 7, 2025

Choose a reason for hiding this comment

greptile-apps bot Mar 7, 2025

Choose a reason for hiding this comment

greptile-apps bot Mar 7, 2025

Choose a reason for hiding this comment

greptile-apps bot Mar 7, 2025

Choose a reason for hiding this comment

raycastbot commented Mar 13, 2025

d0rN834 commented Mar 18, 2025

andreaselia commented Apr 26, 2025