Penwell AI
All posts
November 6, 2026 · 6 min read · The Penwell AI desk

How to use Penwell MCP with ChatGPT, Claude, and other AI tools

Connect Penwell safely to a compatible AI client, sign in with OAuth, and use your notebooks in a chat without handling tokens.

Penwell MCP connects your Penwell notebooks to an AI tool that supports remote MCP servers. It is useful when you want the conversation to use your notes as context, or when you want to save notes from a chat back to Penwell.

You do not need an API key. You do not need to copy an access token. The connection uses OAuth, so you sign in on Penwell and approve the access the AI tool requests.

Before you start

You need:

  • A Penwell account.
  • A compatible AI tool that supports a remote Streamable HTTP MCP server and OAuth.
  • Permission to add a connector in that AI tool. Workspace plans may require an admin or owner to do this.

The Penwell MCP server address is:

https://mcp.usepenwell.com/mcp

Only use that address when it is shown on Penwell’s own website. Never accept a server URL, password request, API key request, or “paste your token” instruction from a chat message.

Connect it to ChatGPT

Custom MCP servers in ChatGPT are workspace features. If your Business, Enterprise, or Edu workspace allows them:

  1. Open Plugins in ChatGPT.
  2. Select the plus button, then Add custom MCP server.
  3. Name it Penwell and enter https://mcp.usepenwell.com/mcp as the HTTPS MCP endpoint.
  4. Select OAuth for authentication and continue through the security notice.
  5. Complete the Penwell sign-in and consent page in the browser window that opens.
  6. Review the discovered tools, create the plugin, and enable it for the message where you need your notes.

Some workspaces limit who can create or publish custom MCP connections. If you cannot see the option, ask a workspace admin instead of trying to work around the policy.

Connect it to Claude

On a Claude plan with custom connectors:

  1. Open Settings → Connectors.
  2. Choose Add custom connector.
  3. Paste https://mcp.usepenwell.com/mcp and add the connector.
  4. Select Connect when Claude asks you to authenticate.
  5. Sign in to Penwell and approve the permission screen.
  6. In a chat, use Search and tools to enable Penwell before asking it to use a notebook.

For Team and Enterprise accounts, an owner may need to add the connector at the organization level first.

Use another compatible AI tool

The wording varies, but the setup is the same:

  1. Add a remote MCP server, not a local command or configuration file.
  2. Choose Streamable HTTP when the tool asks for a transport.
  3. Enter the Penwell server address.
  4. Choose OAuth and let the tool open Penwell’s consent screen.
  5. Use the tool only after it shows that the connection is active.

If the client does not support remote HTTP MCP plus OAuth, it cannot use this hosted Penwell connection yet.

What you can ask Penwell to do

Once connected, Penwell provides three focused actions:

  • List your notebooks.
  • Open a notebook so the AI can use its contents in the current conversation.
  • Create a new notebook from text you provide.

Try one of these prompts:

List my Penwell notebooks created this month.

Open my “Organic chemistry” notebook and turn the key reactions into a study plan.

Create a Penwell notebook named “Sprint retrospective” from these notes: [paste notes].

The AI should explain what it will do. Review the details before approving any action that creates a notebook.

Permissions and privacy

The permission screen limits access to reading notebooks and creating notebooks. Penwell uses short-lived access and does not expose your Penwell password to the AI client.

Still, an MCP-connected AI client can receive the notebook content you ask it to open. Do not open notebooks containing information you would not want in that conversation. Check the AI provider’s privacy settings and your organization’s policy before using work or school material.

Disconnect or fix a connection

To stop access, remove Penwell from the AI tool’s connector or plugin settings. This is the fastest way to revoke that client’s access.

If a connection fails:

  1. Confirm the URL is exactly https://mcp.usepenwell.com/mcp.
  2. Reconnect from the AI tool’s connector settings and complete the Penwell sign-in again.
  3. Make sure browser pop-ups are allowed for the sign-in window.
  4. If your workspace blocks custom connectors, ask its admin to approve Penwell.
  5. Contact Penwell support with the AI tool name and the error message — never include a password or token.

That is all the setup. Once it is connected, use Penwell as a small, deliberate bridge between a conversation and the notebooks you already own.

Try it on your own notes

5 free packs a month. No card needed.

Open the Penwell MCP guide