Agent Integration

1. Generate an Agent Token

Go to app.grovereader.com → Settings → AI agents → Connect an agent. Name it ("Claude Desktop", "Cursor", "Minerva") so you know what to revoke later, and Grove hands you the config below with the token already filled in. The token is shown once.

2. MCP Server

Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible host.

{
  "mcpServers": {
    "grove": {
      "command": "npx",
      "args": ["@grove/mcp-server"],
      "env": { "GROVE_TOKEN": "grv_live_..." }
    }
  }
}

Available tools:

• grove_add_article — Clip a URL to your queue with optional tags and note
• grove_list_queue — List articles by status
• grove_get_article — Full article content, highlights, notes
• grove_update_article — Update status, tags, notes, vault path
• grove_search_library — Full-text search across everything you've saved
• grove_add_highlight — Keep a passage, with an optional note on why it matters
• grove_recent_highlights — Everything highlighted recently, across every article

3. REST API

# Add to queue
curl -X POST https://api.grovereader.com/api/articles/clip \
  -H "Authorization: Bearer grv_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url": "https://...", "tags": ["ai"], "notes": "why you saved it"}'

# List unread
curl https://api.grovereader.com/api/articles?status=unread \
  -H "Authorization: Bearer grv_live_..."

# File to vault
curl -X PATCH https://api.grovereader.com/api/articles/:id \
  -H "Authorization: Bearer grv_live_..." \
  -d '{"status": "filed", "vaultPath": "Research/AI"}'

4. Webhooks

Register a URL to receive a signed POST when an article is created, filed, read, or deleted.

POST /api/webhooks
{
  "url": "https://your-agent.example.com/hook",
  "events": ["article.created", "article.filed"],
  "vaultPath": "Research/AI"  // optional filter
}

Full webhooks guide → — event payloads, signature verification.