Integrations
Provides support for storing Perplexity API keys securely in environment variables for better security practices when sharing code.
Allows Claude to perform web-based research through Perplexity AI's API, providing answers with citations. Supports configuration of parameters like temperature, max tokens, domain filtering, and recency filtering.
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
- Install Git:
- For Mac:
- Install Homebrew first by pasting this in Terminal:
Copy- Then install Git:
Copy - For Windows:
- Download Git from git-scm.com
- Run the installer
- For Mac:
- Install Node.js:
- For Mac: Copy
- For Windows:
- Download from nodejs.org
- Run the installer
- For Mac:
- Verify installations by running:
Tool Installation
- Clone the repository
- Install dependencies
- 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:Or simply create a new file namedCopy
.env
in your text editor - Add your API key to the .env file:Copy
- Install dotenv:Copy
- Update server.js:Copy
- 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.
- 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 lengthsearch_domain_filter
: Restricts search to specific domainssearch_recency_filter
: Filters by time period (day/week/month/year)
Troubleshooting
- Git not found:
- Make sure you've installed Git correctly
- Try restarting your terminal
- On Mac, make sure Homebrew is in your PATH
- Node.js errors:
- Verify Node.js installation with
node --version
- Try reinstalling Node.js
- Verify Node.js installation with
- 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
- 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
You must be authenticated.
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
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.
Related Resources
Related MCP Servers
- AsecurityFlicenseAqualityThis server provides access to the Perplexity AI API, enabling interaction through chatting, searching, and documentation retrieval within MCP-based systems.Last updated -52JavaScript
- AsecurityFlicenseAqualityProvides a standardized way to integrate Perplexity AI's features like chat, search, and documentation access into MCP-based systems.Last updated -5JavaScript
- -securityFlicense-qualityAllows Claude or other MCP-compatible AI assistants to search the web and get up-to-date information using the Perplexity API, with features for filtering results by time period.Last updated -8Python
- AsecurityAlicenseAqualityAn MCP server that enables Claude to perform web searches using Perplexity's API with intelligent model selection based on query intent and support for domain and recency filtering.Last updated -6JavaScriptMIT License