Claude Desktop Setup
Connect Context Repo to Claude Desktop and access your prompts, documents, and collections directly from Claude's interface. Setup takes about two minutes.
Connect Context Repo to Claude Desktop and access your prompts, documents, and collections directly from Claude's interface. Setup takes about two minutes.
Before you start: You'll need a Context Repo account with an API key and Claude Desktop installed.
Get your API key
Go to Dashboard > Settings > API Keys and click Create API Key. Select the prompts.read and documents.read permissions, then copy the generated key. You'll need it in the next step.
Add the server config
Open the Claude Desktop configuration file. On macOS, this file is located at:
~/Library/Application Support/Claude/claude_desktop_config.jsonIf the file doesn't exist yet, create it. Add the Context Repo MCP Server:
{
"mcpServers": {
"context-repo": {
"command": "npx",
"args": ["-y", "context-repo-mcp"],
"env": {
"CONTEXTREPO_API_KEY": "cr_your_api_key_here"
}
}
}
}Replace cr_your_api_key_here with the API key you copied in the previous step.
If you already have other MCP servers in your config, add the "context-repo" entry inside the existing "mcpServers" object.
Restart Claude Desktop and verify
Quit Claude Desktop completely and reopen it. Start a new conversation and ask:
List my promptsClaude should return a list of your Context Repo prompts. If you haven't created any yet, it'll tell you the list is empty — that still means the connection is working.
What you can do
With Context Repo connected, you can ask Claude to:
- List and search your prompts, documents, and collections
- Create new content directly from the conversation
- Use prompt templates with variables filled in contextually
- Search your knowledge base using semantic or keyword queries
- Explore documents chunk by chunk with Deep Search
- Manage versions — view history and restore previous versions
See the MCP Tools Reference for all 26 available tools.
Troubleshooting
Server not starting
Make sure you have Node.js 18 or later installed. Run node --version in your terminal to check. The npx command needs a working Node.js installation to download and run the MCP server package.
node --version
# Should print v18.x.x or higherConfig file not found
On macOS, the config file lives at ~/Library/Application Support/Claude/claude_desktop_config.json. You can open the directory in Finder with:
open ~/Library/Application\ Support/Claude/If the Claude folder exists but there's no config file, create claude_desktop_config.json with the JSON from the setup step above.
Authentication errors
Verify your API key is correct and hasn't been revoked. You can generate a new key from Dashboard > Settings > API Keys. Make sure there are no extra spaces or line breaks in the CONTEXTREPO_API_KEY value.
Cursor Setup
Connect Context Repo to Cursor and access your prompts, documents, and collections directly from your editor. Setup takes about 60 seconds.
VS Code Setup
Connect Context Repo to VS Code and access your prompts, documents, and collections directly from GitHub Copilot Chat. Setup takes about two minutes.