Use commonplot in ChatGPT, Claude, and Hermes

Once commonplot is connected, articles, papers, posts, and videos that ChatGPT or Claude recommends appear as cards. Choose Save on a card to keep it in commonplot; nothing is saved until you do. The AI can also read your saves, notebooks, and documents to answer questions.

Connect ChatGPTCopy Anchor Link

1. In ChatGPT, turn on Settings → Security and login → Developer mode.
2. Add an app with the URL https://www.commonplot.co/api/mcp and OAuth authentication.
3. Sign in to commonplot when asked and choose Allow connection.

Connect ClaudeCopy Anchor Link

1. In Claude, open Settings → Connectors → Add custom connector.
2. Enter the URL https://www.commonplot.co/api/mcp.
3. Sign in to commonplot when asked and choose Allow connection.

Start a new conversation once connected.

Connect Hermes AgentCopy Anchor Link

1. Add commonplot to ~/.hermes/config.yaml:

   Copy Text

   mcp_servers:
     commonplot:
       url: "https://www.commonplot.co/api/mcp"
       auth: oauth

2. In a new terminal, run hermes mcp login commonplot.

3. Sign in to commonplot in the browser that opens and choose Allow connection.

Hermes stays connected afterward, including in scheduled runs. It works in the terminal, so it shows recommendations as text instead of cards and cannot save them; it can search commonplot and read your saves, notebooks, and documents.

What you can doCopy Anchor Link

• Get recommendations and save them: ask for reading, such as "Recommend five papers on agent evaluation", then choose Save on a card.
• Ask about your saves: for example, "What did I save this week?" or "What are the key points of the RAG evaluation paper I saved?" The AI can search your saves by topic, and see what an item cites, what discusses it and how many people saved it.
• Ask about your notebooks and documents: for example, "Summarize my AI chip supply chain notebook" or "What do my research notes say?" The first time, the AI asks you to allow access to notebooks and documents.
• Write into a notebook: for example, "Put these notes in my AI research notebook" or "Add the three papers we discussed to my thesis notebook." The AI only writes when you ask. The first time, it asks you to allow adding to notebooks.
• Read in the conversation: choose Read on a saved card to open the full text in the chat.

To make sure the AI uses commonplot, mention @commonplot, as in "@commonplot recommend reading on MCP".

What the AI can accessCopy Anchor Link

Once connected, the AI can:

• Search public commonplot content
• List and read your saved resources, including private files you uploaded
• Save links when you choose Save, and check their progress
• With your separate permission, read your notebooks and documents
• With another separate permission, create documents and add saves in the notebooks you name; it never edits or deletes what is already there

It cannot read other users' private data. Links saved through the AI appear on your public profile, like any other save. Content the AI reads is sent to the app you connected and the model provider it uses, under their privacy policies; see the commonplot privacy policy.

DisconnectCopy Anchor Link

In commonplot, go to Settings → Account → Connected apps and choose Disconnect. Access stops immediately. Items you already saved stay.

Get helpCopy Anchor Link

Email [email protected] with the app you use (ChatGPT, Claude, or Hermes) and what happened.