Skip to content
Connect your AI

ChatGPT

Bring your notes, project decisions and research into ChatGPT. A MindWiki connection lets ChatGPT retrieve relevant pages, cite its sources and, when the host exposes write tools and you approve them, save useful results back to your vault.

Add the connection

Use ChatGPT on the web with an account or workspace that allows custom MCP connections. In the current interface:

  1. Open Plugins, select +, then Add custom MCP server.
  2. Name the connection MindWiki and enter https://api.mindwiki.io/mcp as the public server URL.
  3. Choose OAuth authentication, review the connection notice and create the plugin.
  4. Complete MindWiki sign-in and let ChatGPT discover the tools.
  5. Enable the connection in the conversation where you want to use it.

If your workspace uses the older Apps interface, use Settings → Apps → Create, enter the same endpoint, choose OAuth and scan the tools. Workspace owners may need to create or enable the connection for members. If custom connections are unavailable, ask your workspace owner about the supported setup path.

A sentence in a ChatGPT conversation cannot change workspace permissions or install a connector through settings. Complete the connection first, then use the prompts below.

Complete the MindWiki connection

On MindWiki's authorization page, MindWiki Email + Access Key is the recommended sign-in method. Existing email-and-password accounts can choose Legacy Sign In; Sign in with Apple remains available. All methods open the same account and vault—no replacement account is required. New users choose Create a new vault, save their generated access key and continue. Review the requested permissions and choose read-only access when that is all you need. Access Keys explains the supported methods.

Return to your agent after approving. Your sign-in key belongs on MindWiki's pages, not in chat or an MCP configuration file. The client handles its own OAuth credentials.

Check that it works

Ask your agent:

text
Use MindWiki to read my account status, then search for a note about one of my projects. Read a matching page and cite its title and path. Tell me if the vault is empty rather than making up a result.

Inspect the tool result and compare it with a page in MindWiki Cloud. For a new vault, the agent can read the operating guide and initialize the starter pages when account status permits it.

To check saving after granting write or capture access, ask “Save a new MindWiki capture titled Connection check with today's date, then read it back and give me its path.” The same file is available in your MindWiki apps.

Browse and edit with MindWiki

  • Vault and conversation panel. Ask ChatGPT to open the interactive MindWiki vault. When the host provides a launcher, open MindWiki Vault from the sidebar or MindWiki Notes from the conversation's tools. Search, preview a note, and use New capture if your connection permits capture. The selected note's Open in MindWiki action opens it in the vault.
  • Mention a note on Mac. Type @ in the desktop composer, select your MindWiki connection, then press Tab when Press Tab to search appears. Type the note title and select the note to attach its reference to your draft.
  • Edit Markdown on Mac. Open a project Markdown file in a file tab. In that tab's Open menu, choose MindWiki Markdown Viewer and Editor under Open in ChatGPT. Use Edit Markdown and Save changes when ChatGPT grants write access to the file. Availability depends on how the host opens the file.
  • Confirm a capture. On a client that offers the native confirmation form, ask MindWiki to review a capture before saving. Choose Save this note to write it to the Inbox or Keep the draft in chat to cancel the save. If the form is unavailable, open the vault and use New capture.
  • Wrap preview text. When the host shows this option in MindWiki's plugin settings, use it to fit long lines to the preview pane. Saving the setting requires a connection authorized to update it.

If you already connected MindWiki and these tools are missing, refresh the connection’s tools in ChatGPT plugin settings. A preference update may prompt you to authorize its dedicated permission. See OpenAI’s supported extension surfaces for platform availability.

Open a note link on iPhone

Open the HTTPS ChatGPT note link in Safari while signed in. Safari can show the note inside the MindWiki Vault widget. Tap Open in Safari’s ChatGPT banner to continue in the installed app. If a chatgpt://plugins/ link lands on your previous screen, try the same link with https://chatgpt.com/plugins/ at the start. You can also open MindWiki Vault in ChatGPT Work and search for the note’s title. Use the workspace and MindWiki account that have access to the note. OpenAI deep link format

Watch a note for updates

Where MindWiki event subscriptions are enabled, use ChatGPT Work on the web or select Work and Cloud in the desktop app. Your workspace must allow plugins and event-triggered tasks. Use a ChatGPT OAuth connection with read access and verified client metadata. An older connection may still work for search and capture. If Events are missing, check whether its plugin uses ChatGPT’s client metadata document (CIMD) before reconnecting. For example, “Watch projects/launch/brief.md for note.updated and let me know when it's edited in MindWiki.” Ask ChatGPT to stop watching when you are done. OpenAI’s OAuth client registration guide · OpenAI’s MCP Events guide

Useful things to ask

  • Find the original decision: “Find my notes about the pricing change. Read the sources and explain what was decided and why.”
  • Research with continuity: “Compare today's findings with my existing research notes and identify what is new.”
  • Turn discussion into memory: “Save a concise summary of this conversation, including the decisions and open questions.”
  • Plan across projects: “Read my active project notes and suggest a plan grounded in the deadlines actually recorded there.”

For search-focused sessions, ask for page titles and paths so you can open the source. ChatGPT may expose a different set of tools in each mode; use the tools actually enabled for that conversation.

Troubleshooting

If ChatGPT answers without calling a tool, explicitly ask it to use the MindWiki connection and inspect the tool result. If it can read but cannot save, confirm write tools are available in the selected mode and that your approved grant permits the action. Refresh the workspace's tool configuration or reconnect when its controls require it.

Permissions and disconnecting

Available tools depend on the scopes you approved, your MindWiki plan and vault permissions, and the tools your client exposes. Free includes one external AI connection with core vault tools. See MCP tool access.

To disconnect just this client, revoke its grant in MindWiki Connections. Other agents keep their own connections. Never send access keys or OAuth tokens to support.

More help

MCP tools · Agent permissions · All AI agents

Setup reference: ChatGPT custom MCP connections, checked October 20, 2026.