ChatGPT App

Access your prompts, documents, and collections from ChatGPT conversations. The Context Repo ChatGPT App connects with OAuth to the hosted MCP server's 29 tools, including the OpenAI Apps SDK Company Knowledge tools `search` and `fetch`.

The Context Repo ChatGPT App gives ChatGPT access to your prompts, documents, and collections. Instead of copying and pasting between tabs, you can ask ChatGPT to search your workspace, retrieve a prompt, or create a document. The ChatGPT host decides which advertised tool to call.

It connects to the same hosted MCP server used by other clients like Claude, Cursor, and VS Code. That server registers 29 tools: 27 repository tools plus the OpenAI Apps SDK Company Knowledge tools search and fetch. Authentication uses OAuth, so you sign in with your Context Repo account from ChatGPT.

Add Context Repo from ChatGPT Plugins. ChatGPT will connect the app with OAuth.

Getting Started

Turn on Developer mode

In ChatGPT, open Settings → Security and login and turn on Developer mode. Availability can depend on your account and workspace policy.

Open ChatGPT Plugins

Go to ChatGPT Plugins and select the plus button.

Connect the MCP server

Enter these values:

FieldValue
NameContext Repo
DescriptionAccess your prompts, documents, and collections. Search, create, update, and organize your AI context.
MCP Server URLhttps://contextrepo.com/mcp
AuthenticationOAuth
OAuth Client ID(leave blank)
OAuth Client Secret(leave blank)

Check the "I understand and want to continue" confirmation if ChatGPT shows it, then create the app connection. ChatGPT will connect the app with OAuth. Sign in with the same Context Repo account you use on the dashboard.

No API key is needed for the ChatGPT App. The ChatGPT connection uses OAuth.

Start using your context

Ask ChatGPT anything about your workspace. For example:

  • "List my prompts about code review"
  • "Search my documents for rate limiting"
  • "Create a new prompt called Weekly Standup Notes"
  • "Show me version history for my API docs prompt"

ChatGPT picks the right tool and returns results directly in the conversation.

Available Tools

The ChatGPT App connects to all 29 hosted Context Repo MCP tools, organized into 8 categories:

CategoryToolsWhat they do
User Info1 toolGet your account details
Prompts7 toolsList, get, create, update, delete prompts, plus view and restore version history
Documents7 toolsList, get, create, update, delete documents, plus view and restore version history
Collections7 toolsList, get, create, update, delete collections, plus add and remove items
Search1 toolFind prompts, documents, and collections by semantic or keyword search
Deep Search3 toolsSearch within document content, read specific chunks, and navigate document hierarchy
Reasoning1 toolGet a best-effort cited answer with citations and non-exhaustive limitations. Disagreements appear as ordinary cited statements in the answer.
Company Knowledge compatibility2 toolsSearch the catalog and fetch one prompt, document, or collection in the shape expected by the OpenAI Apps SDK

For the complete parameter reference, see the MCP Tools Reference.

What You Can Do

The ChatGPT App connects to the same tool inventory as the MCP server. ChatGPT decides which tools it will offer or call in a conversation. Here are common workflows:

Prompt management

Ask ChatGPT to find, use, or modify your prompt templates:

  • "Show me my code review prompts" — uses search_prompts with a search filter
  • "Get the full content of my PR Review Assistant prompt" — uses read_prompt
  • "Update my deployment checklist prompt with a new security section" — uses update_prompt
  • "Restore my API docs prompt to the version from last week" — uses get_prompt_versions and restore_prompt_version

Document search and retrieval

Find exactly what you need across your entire workspace:

  • "Search my documents for authentication patterns" — uses find_items with semantic search
  • "What do my research notes say about caching strategies?" — uses deep_search for content-level results
  • "Show me more context around that caching section" — uses deep_expand to navigate surrounding content

Collection organization

Manage your knowledge base structure through conversation:

  • "List my collections" — uses list_collections
  • "Add my latest document to the Research collection" — uses add_to_collection
  • "Create a new collection called Q1 Planning" — uses create_collection

How Authentication Works

The ChatGPT App uses a hosted OAuth flow for authentication. Here's what that means in practice:

  1. When you first use the app, ChatGPT redirects you to Context Repo's sign-in page.
  2. You log in with your existing Context Repo credentials (email, Google, GitHub, or any method you've set up).
  3. After authorizing, ChatGPT manages the connection until it expires, is revoked, or needs authorization again.

This differs from the documented context-repo-mcp stdio setup for Cursor or Claude Desktop, which uses a Context Repo API key. The ChatGPT App does not require you to generate a key.

OAuth and API-key connections resolve to the same Context Repo account, but they do not carry identical authority. Interactive session and OAuth tokens carry the signed-in user's authority. API keys are limited to the prompt or document scopes granted to that key; collections share the document scopes.

Troubleshooting

Sign-in prompt doesn't appear

Try starting a new conversation with the Context Repo app. If the sign-in flow still doesn't trigger, clear your ChatGPT browser cache and try again.

"Authentication failed" error

Make sure you're signing in with the same account you use on the Context Repo dashboard. If you have multiple accounts, check which email address is associated with your workspace.

Tools not responding

If a tool call returns an error, verify that your Context Repo account is active. You can test your account by logging into the dashboard directly.

ChatGPT expects an old field or tool shape

ChatGPT can cache the MCP tool schemas it discovered when you connected the app. After Context Repo changes a tool's parameters or output, refresh the Context Repo app in ChatGPT before testing again.

If ChatGPT still sends a removed parameter or expects an old response field, remove the Context Repo app connection, create it again with https://contextrepo.com/mcp, and complete the OAuth authorization again. Then start a new conversation so ChatGPT discovers the current schemas.