npm package: @provue/mcp
Description: Installer and setup utility for the Provue MCP server across clients (Claude, Cursor, VS Code, Claude Code).
Author: Provue
Latest version: 0.1.4

# Provue MCP Server

Provue is a Model‑Context‑Protocol (MCP) server that lets your AI client securely perform actions across your tools. Connect once and use Provue from major AI clients like Cursor, Claude Desktop, VS Code, and Claude Code.

## Why Provue?

- **Works across clients** – Use Provue from Cursor, Claude Desktop, VS Code, Claude Code, or any MCP‑compatible client.
- **Rich toolset** – Email, files, search, knowledge, content workflows, and more.
- **Natural commands** – Ask in plain English; Provue handles the underlying operations.
- **Team‑friendly** – Bring your own credentials and scale usage across your team.

## Prerequisites

1. An AI client that supports the MCP protocol (Cursor, Claude Desktop, VS Code, Claude Code, or any generic MCP client)
2. Access to the apps you want to connect (OAuth/API keys as required by each tool)

## Quick Start (npm)

Install via npx (no global install needed):

```bash
npx @provue/mcp@latest setup
```

The setup wizard will configure Provue for your AI client.

## Installing Provue

### Cursor

Option 1 – Use the setup wizard (recommended):

```bash
npx @provue/mcp@latest setup --client cursor
```

Option 2 – Manual setup:

1. In Cursor, click **Add MCP Server**.
2. Enter:
   - **Name** – `Provue`
   - **Type** – `streamableHttp`
   - **URL** – `https://mcp.provue.ai/mcp`
3. Confirm and authenticate when prompted.

### Claude Desktop

For Pro/Max Plans (manual setup):

1. Copy the Provue MCP URL: `https://mcp.provue.ai/mcp`.
2. Open **Claude Desktop** → **Settings** → **Connectors** → **Add custom connector**.
3. Enter a name (e.g. `Provue`), paste the MCP URL, and click **Add**.
4. Click **Connect** and complete the authentication.

For Free/Pro Plans (auto setup):

```bash
npx @provue/mcp@latest setup "https://mcp.provue.ai/mcp" "Provue" --client claude
```

Then restart Claude Desktop.

### VS Code

Option 1 – Use the setup wizard:

```bash
npx @provue/mcp@latest setup --client vscode
```

After installation:

1. Restart VS Code.
2. Open settings and ensure MCP features are enabled in your chat extension.

### Claude Code (CLI + Chat)

Register the server with Claude Code:

```bash
claude mcp add --transport http Provue -s user "https://mcp.provue.ai/mcp"
```

Then in Claude Code chat:

1. Run `/mcp` and select **Provue**.
2. Authenticate in the browser flow.

### Generic MCP Client

If your client supports MCP via URL, supply: `https://mcp.provue.ai/mcp` and follow the client’s docs to add and authenticate the server.

## Using Provue

- Email with Gmail (read, search, label, send)
- Google Drive/Docs/Sheets/Calendar actions
- Web search (Google, Perplexity), Wikipedia
- Provue Knowledge, Context, Playbooks, Studio (content)
- YouTube lookups

### Tool catalog

- Actions: Run reusable Provue actions and automations for common workflows.
- Context: Save and retrieve your brand voice, facts, and preferences.
- Gmail:
  - Read, search, and summarize threads
  - Add/remove labels, archive/star
  - Draft and send replies in your tone
- Google_Calendar:
  - Create events with attendees and conferencing
  - Check availability and suggest times
  - List, update, or cancel events
- Google_Docs:
  - Create docs from prompts/outlines
  - Insert, rewrite, summarize sections
  - Share links for collaboration
- Google_Drive:
  - Search files/folders by name or content
  - Upload assets and organize
  - Manage sharing and permissions
- Google_Maps:
  - Look up places and details
  - Find routes or nearby options
- Google_Search:
  - General web search for facts and sources
- Google_Spreadsheet:
  - Create/update sheets
  - Append rows, edit ranges, generate reports
- Knowledge:
  - Add files, URLs, or text as your knowledge base
  - Ask grounded questions with citations
- Perplexity:
  - Deeper web research with cited sources
- Playbooks:
  - Multi‑step, cross‑tool workflows you can reuse
- Studio:
  - Generate podcasts, audiobooks, videos from scripts
  - Track status and iterate
- Wikipedia:
  - Search topics and fetch summaries
- YouTube:
  - Search channels/videos and pull metadata

Notes

- You may be asked to sign in the first time (opens in your browser).
- Some tools depend on your account access and permissions.

Help

- Website: https://provue.ai
- If something doesn’t connect, restart Claude and try again.