Agent Integration

Grove is designed for the agentic era. Connect any MCP-compatible AI agent to your reading queue.

1. Generate an Agent Token

Go to app.grovereader.com → Settings → Tokens → New Token. Give it a name ("Claude Agent", "Cursor", "Minerva") so you know what to revoke later.

grv_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

2. MCP Server

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

Claude Desktop config (~/.claude/claude_desktop_config.json)

{
  "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 — Search your filed library

3. REST API

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

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

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

4. Webhooks Coming soon

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

← Back to Docs