Perplexity Tool for Claude Desktop

A custom MCP tool that integrates Perplexity AI's API with Claude Desktop, allowing Claude to perform web-based research and provide answers with citations.

Prerequisites Installation

1. Install Git:

   • For Mac:

     • Install Homebrew first by pasting this in Terminal:

     /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

     • Then install Git:

     brew install git

   • For Windows:

     • Download Git from git-scm.com

     • Run the installer

2. Install Node.js:

   • For Mac:

     brew install node

   • For Windows:

     • Download from nodejs.org

     • Run the installer

3. Verify installations by running:

Tool Installation

1. Clone the repository

2. Install dependencies

3. Set up your API Key

You have two options:

Option 1 (Quick setup):

• Open server.js

• Find this line:

• Replace with your Perplexity API key

Option 2 (Best practice):

• Create a .env file:

  # On Mac/Linux: touch .env open .env # On Windows: notepad .env

  Or simply create a new file named .env in your text editor

• Add your API key to the .env file:

  PERPLEXITY_API_KEY=your-api-key-here

• Install dotenv:

  npm install dotenv

• Update server.js:

  import 'dotenv/config' const PERPLEXITY_API_KEY = process.env.PERPLEXITY_API_KEY;

4. Configure Claude Desktop

• Open ~/Library/Application Support/Claude/claude_desktop_config.json

• Add this configuration:

Replace /full/path/to with the actual path where you cloned the repository.

5. Restart Claude Desktop

Usage

Once installed, you can use the tool through Claude with commands like:

• "Ask Perplexity about recent developments in AI"

• "Use Perplexity to research the history of quantum computing"

• "Search Perplexity for information about climate change, focusing on the last month"

Advanced Options

You can specify additional parameters:

• temperature: Controls response randomness (0-2)

• max_tokens: Limits response length

• search_domain_filter: Restricts search to specific domains

• search_recency_filter: Filters by time period (day/week/month/year)

Troubleshooting

1. Git not found:

   • Make sure you've installed Git correctly

   • Try restarting your terminal

   • On Mac, make sure Homebrew is in your PATH

2. Node.js errors:

   • Verify Node.js installation with node --version

   • Try reinstalling Node.js

3. API Key issues:

   • Make sure you've correctly copied your API key

   • Check that there are no extra spaces in your .env file

   • If using Option 2, verify dotenv is installed

4. Tool not appearing in Claude:

   • Check the path in claude_desktop_config.json

   • Make sure the path points to your server.js file

   • Restart Claude Desktop

   • Check the console for any error messages

License

MIT

Security Note

If you're planning to share your code or make it public:

• Don't commit your API key to Git

• Use the .env method (Option 2)

• Add .env to your .gitignore file