Documentation
User Guide for AI Paper Management
Overview
Graphite is a system that efficiently manages research papers and deepens understanding of papers using AI.
Key Features
- PDF upload and automatic text extraction
- Automatic metadata extraction (title, authors, venue, year, DOI)
- AI-powered tag suggestions
- Optional AI summary generation
- AI chat with papers
- Tagging and organizing papers
- Graph view to visualize relationships between papers
- LLM integration via MCP (Claude Desktop, etc.)
Basic Usage
1. PDF Upload
From the Upload page, drag and drop or select PDF files. You can upload up to 10 files at once.
You can also import papers directly from a URL (e.g., arXiv PDF links).
Max: 50MB per file | Format: PDF
2. Viewing Papers
After upload, automatically executed:
- Extract text from PDF
- Automatically extract metadata (title, authors, venue, published year, DOI)
- Automatically suggest up to 3 related tags
- Optionally generate AI summary (configurable in Settings)
3. Manage Tags
Tag papers to group and search them easily.
- Add multiple tags with comma separation
- Autocomplete existing tags
- Manage all tags on tag page
4. Graph View
In the Graph View, papers with common tags are connected, allowing you to visually grasp relationships.
5. AI Chat
Chat with your papers using AI. Ask questions, request explanations, or get insights.
Access chat from each paper's detail page.
AI Request Usage
Each AI-powered feature consumes AI requests. Your monthly limit depends on your plan.
| Feature | Req. | Notes |
|---|---|---|
| PDF Import | 2 | Metadata extraction and Summary generation |
| Next to Read | 1 | Paper recommendations |
| AI Chat | 2 | Query analysis and Response generation |
View usage on Pricing page.
LLM Integration
Connect Graphite to Claude Desktop or other LLM clients via MCP (Model Context Protocol).
1. Create API Token
- Go to Settings
- Scroll to "API Tokens" section
- Click "Create Token"
- Copy the token immediately
Format: gph_xxxx
2. Configure Claude Desktop
Edit the config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Add configuration:
{
"mcpServers": {
"graphite": {
"command": "/path/to/uv",
"args": ["run", "--project", "/path/to/graphite", "python", "-m", "mcp_server"],
"env": {
"GRAPHITE_URL": "http://localhost:8000",
"GRAPHITE_API_TOKEN": "gph_your_token_here"
}
}
}
}
3. Available Tools
| Tool | Description |
|---|---|
list_papers | List papers |
get_paper | Get paper details |
get_paper_content | Get extracted content |
search_papers | Full-text search |
upload_pdf_url | Upload from URL |
update_memo | Update paper memo |
list_tags | List all tags |
add_tags | Add tags to paper |
remove_tag | Remove tag from paper |
4. Usage Examples
Try asking Claude:
- "List my recent papers"
- "Search for papers about transformer architecture"
- "Upload this arxiv PDF"
- "Add tag 'NLP' to BERT paper"
More Information
For questions or bug reports, please contact us via GitHub Issues.