# Grove

> Grove is a read-it-later app for personal knowledgebases, file-first systems, and AI/agent-assisted workflows.

Grove is open source (AGPL-3.0) and designed for PKM (personal knowledge management) users who use tools like Obsidian, Notion, or Logseq. Unlike general read-it-later apps, Grove syncs articles directly to your vault as markdown notes and exposes a full API for AI agents.

## Key Concepts

- **Queue**: Your reading inbox — unread, reading, or done articles
- **Library**: Filed articles with highlights, notes, and tags — your knowledge archive
- **Vault Sync**: Articles saved as markdown to your Obsidian/PKM vault
- **Agent Tokens (PAT)**: Named API tokens for AI agents and automations

## Docs

- [Agent Integration](https://grovereader.com/docs/agents): MCP server, webhooks, PAT tokens — how to connect AI agents to Grove
- [API Reference](https://grovereader.com/docs/api): REST API for articles, tokens, vault sync, and admin
- [Obsidian Plugin](https://grovereader.com/docs/obsidian): Setup, PAT auth, vault folder configuration
- [Chrome Extension](https://grovereader.com/docs/extension): Installation, login, clipping articles
- [Pricing](https://grovereader.com/docs/pricing): Free / Pro $19/yr / Pro $49 lifetime

## API

Base URL: `https://api.grovereader.com/api`

Authentication: `Authorization: Bearer grv_live_<64-hex-chars>`

Key endpoints:
- `GET /health` — health check
- `GET /articles` — list articles (query: status, limit, tags)
- `POST /articles` — clip a URL to queue (body: url, title, tags, notes)
- `GET /articles/:id` — get article with content, highlights, notes
- `PATCH /articles/:id` — update status, tags, notes, vaultPath
- `DELETE /articles/:id` — delete article
- `GET /tokens` — list agent tokens
- `POST /tokens` — create agent token (body: label)
- `DELETE /tokens/:id` — revoke token
- `GET /vault/folders` — list vault folders
- `POST /vault/folders` — add vault folder

## MCP Server

```bash
npx @grove/mcp-server
# Set env: GROVE_TOKEN=grv_live_...
```

Tools: `grove_add_article`, `grove_list_queue`, `grove_get_article`, `grove_update_article`, `grove_search_library`

## Links

- [Homepage](https://grovereader.com)
- [App](https://app.grovereader.com)
- [GitHub](https://github.com/jmagnuss/grove)
- [API Health](https://api.grovereader.com/api/health)
- [API Base](https://api.grovereader.com/api)