OpenGraph.io

MCP Server for Claude Desktop — Give Claude Real-Time Web Access

Connect Claude Desktop to the OpenGraph.io MCP server and unlock metadata extraction, screenshot capture, web scraping, and AI-powered page queries — all from your Claude conversations.

Claude Desktop + MCP
Claude DesktopAnthropic's AI assistant
stdio
opengraph-io-mcpruns locally on your machine
REST API
OpenGraph.io APIapi.opengraph.io
Tools Available in Claude
Link Previews
Screenshots
Web Scraping
AI Query
npx -y opengraph-io-mcp
Capabilities

What Claude Desktop Can Do with OpenGraph.io MCP

Once connected, Claude automatically discovers these tools and calls them when relevant — just ask in natural language.

Fetch Link Previews

Ask Claude to unfurl any URL and get OpenGraph metadata, Twitter Cards, and HTML meta tags — perfect for research and SEO analysis.

get_og_data

Capture Screenshots

Have Claude take full-page or viewport-sized screenshots of any webpage for visual analysis, competitive research, or QA checks.

screenshot

Scrape Web Content

Claude can scrape full HTML from any page with JavaScript rendering and bot detection bypass — ideal for content extraction and migration.

scrape

Ask Questions About Pages

Query any webpage with natural language and get structured answers — extract pricing data, summarize articles, or validate deployments.

query
Setup Guide

Set Up Claude Desktop MCP in Under 2 Minutes

Connecting Claude Desktop to the OpenGraph.io MCP server takes just four steps. No coding required — just paste a JSON config and restart.

  • 1Get your free App ID: Sign up at dashboard.opengraph.io — the free tier includes 100 credits per month.
  • 2Open the config file: On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 3Paste the MCP config: Add the OpenGraph.io MCP server entry with your App ID (see the config panel).
  • 4Restart Claude Desktop: Quit completely and reopen. Look for the hammer icon — that means MCP tools are ready.
claude_desktop_config.json
{
  "mcpServers": {
    "opengraph": {
      "command": "npx",
      "args": [
        "-y",
        "opengraph-io-mcp"
      ],
      "env": {
        "OPENGRAPH_APP_ID": "YOUR_OPENGRAPH_APP_ID"
      }
    }
  }
}
Platform Details

Config File Location by Platform

Claude Desktop stores its MCP configuration in a platform-specific location. Find yours below.

macOS
~/Library/Application Support/Claude/claude_desktop_config.json

Open Finder, press Cmd+Shift+G, and paste the path above. Create the file if it doesn't exist.

Example Prompts

What to Ask Claude After Setup

Once the MCP server is connected, Claude automatically knows which tool to use. Just ask naturally — here are some examples to get you started.

  • SEO audit: “Unfurl https://example.com and tell me if the OG tags are properly configured.”
  • Visual comparison: “Screenshot https://stripe.com and https://square.com and compare their homepage designs.”
  • Content extraction: “Scrape the pricing page at https://openai.com/pricing and create a comparison table.”
  • Page analysis: “Query https://anthropic.com and summarize their main product offerings.”
  • Competitor research: “Get the metadata from my top 5 competitor URLs and compare their title tags.”

Research & Analysis

Unfurl URLs, extract metadata, and have Claude summarize findings — all in one conversation.

Visual Comparison

Capture screenshots of multiple pages and ask Claude to compare layouts, designs, or content.

Content Extraction

Scrape page content and have Claude transform it into tables, summaries, or structured data.

Security

Your API Key Never Reaches Claude

The MCP server runs locally on your machine. Your OpenGraph.io App ID stays in your config file and is never transmitted to the AI model.

Local Config Storage

Your App ID is stored in the Claude Desktop config file on your machine — never exposed to the AI model.

Local Subprocess

The MCP server runs as a subprocess of Claude Desktop on your machine. No cloud hosting, no shared infrastructure.

Stdio Transport

Communication uses standard input/output between Claude and the MCP server. No open ports, no network exposure.

No Persistent State

The server doesn't cache responses locally or maintain session state. Every request is stateless and ephemeral.

Troubleshooting

Common Issues & Fixes

Most issues are solved by one of these steps. If you're still stuck, check the full troubleshooting guide.

  • Hammer icon not showing: Fully quit Claude Desktop (check system tray) and reopen. A background process may be lingering.
  • JSON parse error: Validate your config file at jsonlint.com. Common culprit: trailing commas.
  • Node.js not found: Ensure Node.js 18+ is installed — run node --version in your terminal.
  • Invalid App ID: Verify your App ID at dashboard.opengraph.io.
Log Locations
macOS: ~/Library/Logs/Claude/
or
Windows: %APPDATA%\Claude\logs\
Cross-Platform

One MCP Server, 8+ AI Clients

The same opengraph-io-mcp package powers every client below. Only the config file format differs.

Our Clients

Trusted by Thousands

Over 1B Site Previews!

Try it for free today

Get started with 100 free API requests per month. No credit card required. Experience the power of our API with zero commitment.

FAQ

Install the OpenGraph.io MCP server by adding a JSON config to your Claude Desktop config file. Once configured, Claude can fetch link previews, capture screenshots, scrape web pages, and answer questions about any URL — all natively within your Claude conversations. Setup takes under 2 minutes.
Claude Desktop supports the Model Context Protocol (MCP), an open standard that lets Claude connect to external tools. The OpenGraph.io MCP server runs locally on your machine and gives Claude access to web data tools — metadata extraction, screenshots, scraping, and AI-powered page queries — without exposing your API key to the model.
The MCP server itself is free and open-source. It connects to the OpenGraph.io API, which includes a free tier with 100 credits per month. Metadata extraction costs 1 credit, screenshots cost 20 credits (1 if cached), and AI queries cost 100–200 credits. Paid plans start at $25/month for 50,000 credits.
Claude gains four powerful capabilities: (1) Extract OpenGraph metadata, Twitter Cards, and HTML meta tags from any URL, (2) Capture full-page screenshots at any viewport size, (3) Scrape rendered HTML with JavaScript execution, and (4) Ask natural-language questions about any webpage and get structured answers.
You need Node.js 18 or later installed on your machine for the npx command to work. The MCP server itself is installed automatically via npx when Claude Desktop starts — no separate installation step is required.
Yes. Your OpenGraph.io App ID is stored in a local config file on your machine and is never sent to the Claude AI model. The MCP server runs as a local subprocess using stdio transport (standard input/output), so there are no open network ports and no data leaves your machine except the API calls to OpenGraph.io.
The most common issues are: (1) Claude Desktop needs a full restart — quit completely (check your system tray) and reopen, (2) The JSON config file has a syntax error such as a trailing comma, (3) Node.js 18+ is not installed. Check Claude Desktop logs at ~/Library/Logs/Claude/ (macOS) or %APPDATA%\Claude\logs\ (Windows) for specific error messages.
Yes. The OpenGraph.io MCP server works with Claude Desktop, Claude Code (CLI), Cursor, VS Code (Copilot Chat), Windsurf, JetBrains AI Assistant, Zed, and Cline. The same server package works across all clients — only the config file format differs.

Still have Questions? 🤔

Can't find the answer you're looking for? Please chat to our friendly team. We usually respond within 24 hours.