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

  1. Go to Settings
  2. Scroll to "API Tokens" section
  3. Click "Create Token"
  4. Copy the token immediately

Format: gph_xxxx

2. Configure Claude Desktop

Edit the config file:

macOS: ~/Library/Application Support/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_papersList papers
get_paperGet paper details
get_paper_contentGet extracted content
search_papersFull-text search
upload_pdf_urlUpload from URL
update_memoUpdate paper memo
list_tagsList all tags
add_tagsAdd tags to paper
remove_tagRemove 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"

For questions or bug reports, please contact us via GitHub Issues.