OpenGraph.io
Log inStart Free

Set Up OpenGraph.io MCP in Claude Desktop

Connect Claude Desktop to OpenGraph.io so Claude can preview URLs, extract clean content, capture screenshots, audit pages, and generate images — all from your conversations. Add the connector in Settings and sign in.

No credit card required.

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
Preview
Extract & Markdown
Screenshots
Site Audit
Image Generation
mcp.opengraph.io/mcp
What You Can Do

What You Can Do with Claude

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

Summarize a Webpage

Ask Claude to preview any URL — title, description, image, favicon, and Open Graph metadata — and summarize what the page is about.

getOgData

Extract Clean Content

Have Claude convert an article, doc, or blog post to clean Markdown so it can read and reason over the content without HTML noise.

getOgMarkdown

Capture a Screenshot

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

getOgScreenshot

Check Link Preview Metadata

Ask Claude to check how a URL will look when shared on Facebook, X, or LinkedIn, and flag any missing Open Graph or Twitter Card tags.

getLinkPreview

Audit a URL

Get an instant quality check on a single page, or ask Claude to kick off a full site audit and summarize the top SEO and social-sharing fixes.

previewPageAudit

Generate an Image

Ask Claude to create a diagram, icon, or social card from a prompt and export the result as an image file.

generateImage
Using Claude Code instead? This page covers Claude Desktop. Claude Code (Anthropic's CLI agent) uses a different setup command.View Claude Code setup →
Setup Guide

Set Up Claude Desktop MCP in Under 2 Minutes

Add OpenGraph.io as a custom connector in Settings — hosted is selected by default and needs no separate install.

  • 1Open Settings: In Claude Desktop, go to Settings → Connectors.
  • 2Add a custom connector: Paste https://mcp.opengraph.io/mcp as the URL.
  • 3Sign in: Click Add, then sign in with your OpenGraph.io account when prompted.
  • 4Verify: The connector shows as active — start a new chat and ask Claude what tools it has.
Settings → Connectors
Name
OpenGraph.io
URL
https://mcp.opengraph.io/mcp
Add

Sign in with your OpenGraph.io account when prompted.

Try It First

Your First Test Prompt

Once the hammer icon appears, paste this into your Claude conversation to confirm everything is wired up correctly.

Try this in Claude
Use OpenGraph.io to preview this URL and summarize the title, description, image, and metadata.
Platform Details

Config File Location by Platform

This only applies to the local (npx) setup — hosted connectors are managed entirely in Settings → Connectors, no file editing required. If you're running the server locally, Claude Desktop stores its config 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, mixing developer and no-code workflows.

  • Summarizing a webpage: “Preview https://anthropic.com and summarize their main product offerings.”
  • Extracting content: “Convert the pricing page at https://openai.com/pricing to Markdown and create a comparison table.”
  • Checking social metadata: “Check the link preview for https://example.com and tell me if the OG tags are properly configured.”
  • Capturing visual context: “Screenshot https://stripe.com and https://square.com and compare their homepage designs.”
  • Auditing a URL: “Audit my landing page at mysite.com/launch and tell me what's missing for SEO and social sharing.”
  • Comparing URLs: “Get the metadata from my top 5 competitor URLs and compare their title tags.”

Research & Analysis

Preview URLs, extract content, 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.

Launch Audits

Run a pre-launch quality check and have Claude walk through the prioritized list of fixes.

Troubleshooting

Common Issues & Fixes

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

  • Config not detected / hammer icon not showing: Fully quit Claude Desktop (check system tray) and reopen. A background process may be lingering.
  • App ID missing or invalid: Verify your App ID at dashboard.opengraph.io matches exactly what's in your config, with no extra spaces or quotes.
  • JSON parse error: Validate your config file at jsonlint.com. Common culprit: trailing commas.
  • Command not found: Ensure Node.js 18+ is installed — run node --version in your terminal.
  • Request failed: Check your credit balance on the dashboard — screenshots and AI queries cost more credits than a metadata lookup and may fail if you're out of balance.
  • URL cannot be accessed: Some sites block automated requests or require authentication. Try a different URL to confirm the server itself is working.
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.

Claude DesktopThis guide
Claude Code
Cursor
VS Code
Windsurf
JetBrains
Zed
Cline
Keep Exploring

Related Pages

All 16 MCP Tools

Browse every capability across Web Data, Site Audit, and Image Generation.

Example Prompts

Copy-paste prompts for previewing, extracting, capturing, and auditing URLs.

MCP Hub

The full overview of OpenGraph.io's MCP server, security model, and client support.

Set Up in Cursor

Prefer coding in Cursor? See the dedicated setup guide with one-click install.

Our Clients

Trusted by Thousands

Over 1B URLs processed

Powering previews, metadata, screenshots, extraction, embeds, and audits.

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

In Claude Desktop, go to Settings, then Connectors, and add OpenGraph.io as a custom connector using the URL https://mcp.opengraph.io/mcp. Sign in with your OpenGraph.io account when prompted. Once connected, Claude can preview URLs, extract clean content, capture screenshots, run audits, generate images, and answer questions about any URL natively within your 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 (hosted by default, or run locally if you prefer) gives Claude URL Intelligence — metadata, content extraction, screenshots, site audits, link preview checks, and image generation — 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 requests 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 all 16 OpenGraph.io MCP tools across three areas: Web Data (metadata, Markdown conversion, HTML scraping, screenshots, and AI-powered page queries), Site Audit & Link Preview (site-wide SEO/social audits and instant single-URL preview checks), and Image Generation (illustrations, diagrams, icons, and social cards).
No, not for the hosted connector — it's added entirely through Settings and requires no separate install. If you'd rather run the server locally, you'll need Node.js 18 or later, since the local option is installed automatically via npx when Claude Desktop starts.
Yes, either way. With the hosted connector, authentication happens through sign-in to your OpenGraph.io account — your credentials are never sent to the Claude AI model. With the local option, your OpenGraph.io App ID stays in a config file on your machine and the server runs as a local subprocess using stdio transport (standard input/output), so no data leaves your machine except the API calls to OpenGraph.io.
For the hosted connector: check Settings > Connectors to confirm it shows as active and that sign-in completed successfully — try removing and re-adding it if not. For the local (npx) option, 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, (4) your App ID is missing or invalid. 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.
Yes. Claude Code (Anthropic's CLI coding agent) supports the same MCP server via the claude mcp add command. See the dedicated Claude Code setup guide for the exact command and project-level config options.

Still have Questions? 🤔

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