LinkedIn to ClickUp CRM Chrome Extension

A powerful Chrome extension that seamlessly integrates LinkedIn with ClickUp, allowing you to extract contact and company information from LinkedIn profiles and save them directly to your ClickUp workspace with customizable field mappings.

Features

• Smart Data Extraction: Automatically extracts profile and company information from LinkedIn pages
• Flexible Field Mapping: Map LinkedIn data to any ClickUp field, including custom fields
• Quick Save: One-click saving after initial setup
• Searchable Lists: Find and select ClickUp lists easily with search functionality
• Dual Support: Works with both LinkedIn profiles (people) and company pages
• Persistent Settings: Saves your configurations and field mappings locally

What Data is Extracted

LinkedIn Profiles (People)

• Full Name
• LinkedIn Profile URL
• Job Title/Description
• Personal Website
• Company Name
• Company LinkedIn URL

LinkedIn Company Pages

• Company Name
• LinkedIn Company Page URL
• Company Logo URL
• Company Website
• Location
• Company Description

Installation

Method 1: Developer Mode (Recommended)

1. Download the Extension Files

   • Clone this repository or download the files
   • Ensure you have all the required files in a folder:
     • manifest.json
     • popup.html, popup.css, popup.js
     • content.js
     • background.js
     • Icon files (icon16.png, icon48.png, icon128.png)

2. Install in Chrome

   • Open Chrome and navigate to chrome://extensions/
   • Enable "Developer mode" (toggle in the top right)
   • Click "Load unpacked"
   • Select the folder containing the extension files
   • The extension will appear in your extensions list

3. Pin the Extension

   • Click the puzzle piece icon in Chrome's toolbar
   • Find "LinkedIn to ClickUp CRM" and click the pin icon
   • The extension icon will now appear in your toolbar

Setup and Configuration

1. Get Your ClickUp API Key

1. Log into your ClickUp account
2. Go to Settings → Apps
3. Click Generate to create a new API key
4. Copy the API key (you'll need this for the extension)

2. Configure the Extension

1. Open the Extension

   • Click the extension icon in your Chrome toolbar
   • Go to the Settings tab

2. Add Your API Key

   • Paste your ClickUp API key in the "ClickUp API Key" field
   • Click "Save API Key"
   • The extension will validate your key and load your ClickUp lists

3. Set Up Field Mappings

   • Choose whether to set up mappings for Profiles, Companies, or both
   • Use the search box to find and select your desired ClickUp list
   • Map LinkedIn data fields to your ClickUp fields
   • Save your mapping configuration

Usage

Quick Save (After Setup)

1. Navigate to LinkedIn

   • Go to any LinkedIn profile or company page
   • You'll see a "ClickUp CRM" button next to the "More" button

2. Extract and Save

   • Click the "ClickUp CRM" button or the extension icon
   • Go to the Quick Save tab
   • Click "Refresh Data" to extract LinkedIn information
   • Click "Quick Save to ClickUp" to create a task with your mapped fields

Managing Settings

• Edit Mappings: Return to Settings to modify field mappings
• Delete Mappings: Remove saved configurations if needed
• Change Lists: Select different ClickUp lists for your data

Field Mapping Examples

Profile Mapping

• LinkedIn "Full Name" → ClickUp "Task Name"
• LinkedIn "Description" → ClickUp "Description"
• LinkedIn "Profile URL" → ClickUp Custom Field "LinkedIn URL"
• LinkedIn "Company Name" → ClickUp Custom Field "Company"

Company Mapping

• LinkedIn "Company Name" → ClickUp "Task Name"
• LinkedIn "Website" → ClickUp Custom Field "Website"
• LinkedIn "Location" → ClickUp Custom Field "Location"
• LinkedIn "Description" → ClickUp "Description"

Building from Source

Prerequisites

• Node.js and npm installed
• Basic knowledge of Chrome extension development

Development Setup

1. Clone the Repository

   git clone <your-repo-url>
   cd linkedin-clickup-extension

2. Install Dependencies

   npm install

3. Development Build

   npm run dev

4. Production Build

   npm run build

File Structure

/
├── public/
│   ├── manifest.json          # Extension manifest
│   ├── popup.html            # Extension popup UI
│   ├── popup.css             # Popup styling
│   ├── popup.js              # Popup functionality
│   ├── content.js            # LinkedIn page interaction
│   ├── background.js         # Background service worker
│   └── icons/                # Extension icons
├── src/                      # React components (if applicable)
└── README.md

API Integration

ClickUp API Endpoints Used

• User Validation: GET /api/v2/user
• Teams: GET /api/v2/team
• Spaces: GET /api/v2/team/{team_id}/space
• Folders: GET /api/v2/space/{space_id}/folder
• Lists: GET /api/v2/folder/{folder_id}/list
• List Fields: GET /api/v2/list/{list_id}/field
• Create Task: POST /api/v2/list/{list_id}/task

Authentication

All API requests require your ClickUp API key in the Authorization header:

Authorization: YOUR_API_KEY

Troubleshooting

Common Issues

1. "Unable to extract data from this page"

   • Ensure you're on a LinkedIn profile or company page
   • Try refreshing the page and the extension
   • Check if LinkedIn has changed their page structure

2. "Invalid API key"

   • Verify your API key is correct
   • Ensure the API key has proper permissions
   • Generate a new API key if needed

3. Lists not loading

   • Check your internet connection
   • Verify your ClickUp account has accessible workspaces
   • Try refreshing the extension

4. Extension button not appearing

   • Refresh the LinkedIn page
   • Check if you're on a profile or company page (not search results)
   • Try navigating to a different profile and back

Debug Mode

1. Open Chrome DevTools (F12)
2. Go to the Console tab
3. Look for extension-related logs
4. Report issues with console output

Privacy and Security

• Local Storage: API keys and mappings are stored locally in Chrome
• No Data Collection: The extension doesn't collect or transmit personal data
• Direct API Calls: All ClickUp communication is direct between your browser and ClickUp
• Permissions: Only requests necessary permissions for LinkedIn and ClickUp integration

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For issues, feature requests, or questions:

1. Check the troubleshooting section above
2. Open an issue on GitHub
3. Include browser version, extension version, and steps to reproduce

Changelog

Version 1.0.0

• Initial release
• Basic LinkedIn data extraction
• ClickUp integration with field mapping
• Searchable list selection
• Quick save functionality
• Settings management