ChatGPT MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on ChatGPT: 33 typed functions through one MCP server. No ChatGPT API key needed.

Functions
33
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just ChatGPT

An MCP server for ChatGPT alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/chatgpt
Every site

One MCP server for ChatGPT and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 17
  • browseGPTStoreLists the GPT Store front page by category.

    Arguments

    None.

    Returns GPTStoreSection[]

    interface GPTSummary {
      id: string;
      name: string | null;
      description: string | null;
      author: string | null;
      url: string | null;
      /** The site's own rounded count string, e.g. "1M+". */
      conversations: string | null;
    }
    
    interface GPTStoreSection {
      id: string | null;
      title: string | null;
      gpts: GPTSummary[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/browseGPTStore

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.browseGPTStore();
  • getAccountReads the CALLER's account.

    Arguments

    None.

    Returns ChatGPTAccount

    interface ChatGPTAccount {
      id: string | null;
      email: string | null;
      name: string | null;
      plan: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/getAccount

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.getAccount();
  • getConversationReads one of the CALLER's conversations in full.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns Conversation

    interface ConversationMessage {
      id: string;
      role: string;
      text: string;
      createTime: string | null;
      /** The model that answered, on assistant turns. */
      model: string | null;
    }
    
    interface Conversation {
      id: string;
      title: string | null;
      createTime: string | null;
      updateTime: string | null;
      gptId: string | null;
      /** The visible thread, oldest first. */
      messages: ConversationMessage[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/getConversation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.getConversation("6956c161-a7a4-8001-bc75-894ecaaa9ae6");
  • getCustomInstructionsReads the CALLER's personalization.

    Arguments

    None.

    Returns CustomInstructions

    interface CustomInstructions {
      enabled: boolean;
      nickname: string | null;
      occupation: string | null;
      traits: string | null;
      aboutYou: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/getCustomInstructions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.getCustomInstructions();
  • getGPTReads one custom GPT's page in the GPT Store.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns GPTDetail | null

    interface GPTSummary {
      id: string;
      name: string | null;
      description: string | null;
      author: string | null;
      url: string | null;
      /** The site's own rounded count string, e.g. "1M+". */
      conversations: string | null;
    }
    
    interface GPTDetail extends GPTSummary {
      conversationStarters: string[];
      categories: string[];
      rating: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/getGPT

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.getGPT("g-2fkFE8rbu");
  • getMemoriesReads what ChatGPT has saved to the CALLER's memory (Settings → Personalization → Manage memories).

    Arguments

    None.

    Returns Memories

    interface Memories {
      memories: { id: string; content: string; updateTime: string | null }[];
      /** Share of the memory budget used, 0-100, when reported. */
      percentFull: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/getMemories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.getMemories();
  • getProjectReads one of the CALLER's projects.

    Arguments

    NameTypeRequired
    idOrUrlstringYes
    opts{ cursor?: string }No

    Returns ProjectDetail

    interface ProjectConversation {
      id: string;
      title: string | null;
      updateTime: string | null;
    }
    
    interface ProjectDetail {
      id: string;
      name: string | null;
      instructions: string | null;
      files: { id: string; name: string | null }[];
      conversations: ProjectConversation[];
      /** Pass back as cursor for more; null at the end. */
      cursor: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/getProject

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.getProject("g-p-6956c161a7a48001");
  • getSharedConversationReads a public shared ChatGPT conversation from its share link (chatgpt.com/share/<id>).

    Arguments

    NameTypeRequired
    urlstringYes

    Returns SharedConversation

    interface SharedMessage {
      role: "user" | "assistant";
      text: string;
      /** Unix seconds, when the site recorded one. */
      createTime: number | null;
      /** The model that wrote an assistant turn, when recorded. */
      model: string | null;
    }
    
    interface SharedConversation {
      shareId: string;
      url: string;
      title: string;
      createTime: number | null;
      updateTime: number | null;
      model: string | null;
      /** The visible thread in order, hidden system turns and tool calls left out. */
      messages: SharedMessage[];
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/getSharedConversation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.getSharedConversation("<url>");
  • listConversationsLists the CALLER's ChatGPT chat history, newest first.

    Arguments

    NameTypeRequired
    opts{ limit?: number; offset?: number; archived?: boolean }No

    Returns ConversationList

    interface ConversationSummary {
      id: string;
      title: string | null;
      createTime: string | null;
      updateTime: string | null;
      gptId: string | null;
      projectId: string | null;
    }
    
    interface ConversationList {
      conversations: ConversationSummary[];
      total: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/listConversations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.listConversations({});
  • listLibraryImagesLists the images the CALLER has generated, from the Library page, newest first, with the conversation each came from.

    Arguments

    None.

    Returns LibraryImage[]

    interface LibraryImage {
      id: string;
      url: string | null;
      prompt: string | null;
      conversationId: string | null;
      createTime: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/listLibraryImages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.listLibraryImages();
  • listModelsLists the models the CALLER's plan can pick in the model menu, with their limits.

    Arguments

    None.

    Returns ChatGPTModel[]

    interface ChatGPTModel {
      /** The id the model menu sends, e.g. "gpt-4o". */
      slug: string;
      title: string | null;
      description: string | null;
      maxTokens: number | null;
      tags: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/listModels

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.listModels();
  • listMyGPTsLists the custom GPTs in the CALLER's sidebar (their own and ones they pinned or used), with visibility and pinned state.

    Arguments

    None.

    Returns MyGPT[]

    interface GPTSummary {
      id: string;
      name: string | null;
      description: string | null;
      author: string | null;
      url: string | null;
      /** The site's own rounded count string, e.g. "1M+". */
      conversations: string | null;
    }
    
    interface MyGPT extends GPTSummary {
      /** "only me", "link" or "store" when the site reports it. */
      visibility: string | null;
      pinned: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/listMyGPTs

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.listMyGPTs();
  • listProjectsLists the CALLER's ChatGPT projects with their names and conversation counts.

    Arguments

    None.

    Returns ProjectSummary[]

    interface ProjectConversation {
      id: string;
      title: string | null;
      updateTime: string | null;
    }
    
    interface ProjectSummary {
      /** g-p-… id; pass to getProject. */
      id: string;
      name: string | null;
      conversations: ProjectConversation[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/listProjects

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.listProjects();
  • listScheduledTasksLists the CALLER's scheduled tasks (reminders and recurring prompts ChatGPT runs on a schedule) with their next run time.

    Arguments

    None.

    Returns ScheduledTask[]

    interface ScheduledTask {
      id: string;
      title: string | null;
      prompt: string | null;
      /** The recurrence the site stores, e.g. "FREQ=DAILY". */
      schedule: string | null;
      nextRun: string | null;
      enabled: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/listScheduledTasks

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.listScheduledTasks();
  • searchConversationsSearches the CALLER's chat history by keyword, the way the sidebar's search does, and returns matching conversations with a snippet.

    Arguments

    NameTypeRequired
    querystringYes
    opts{ cursor?: string }No

    Returns ConversationSearchResult

    interface ConversationSearchHit {
      id: string;
      title: string | null;
      updateTime: string | null;
      /** The matching text, when the site returns one. */
      snippet: string | null;
    }
    
    interface ConversationSearchResult {
      hits: ConversationSearchHit[];
      /** Pass back as `cursor` for the next page; null at the end. */
      cursor: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/searchConversations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.searchConversations("trip");
  • searchGPTsSearches the GPT Store by keyword and returns matching custom GPTs with their id, name, description, author and conversation count.

    Arguments

    NameTypeRequired
    querystringYes

    Returns GPTSummary[]

    interface GPTSummary {
      id: string;
      name: string | null;
      description: string | null;
      author: string | null;
      url: string | null;
      /** The site's own rounded count string, e.g. "1M+". */
      conversations: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/searchGPTs

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.searchGPTs("writing");
Act 16
  • archiveConversationArchives (or un-archives) one of the CALLER's conversations.

    Arguments

    NameTypeRequired
    conversationstringYes
    opts{ archived?: boolean }No

    Returns WriteResult

    interface WriteResult {
      ok: boolean;
      /** The conversation, memory or share id the write acted on. */
      id: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/archiveConversation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.archiveConversation("<conversation>");
  • createGPTCreates a custom GPT in the CALLER's account.

    Arguments

    NameTypeRequired
    draft{ name: string; description?: string; instructions?: string; promptStarters?: string[] }Yes

    Returns CreatedGPT

    interface CreatedGPT {
      /** The g-… id getGPT, pinGPT and sendMessage take. */
      id: string;
      name: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/createGPT

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.createGPT({});
  • createProjectCreates a new project in the CALLER's account with a name and optional instructions.

    Arguments

    NameTypeRequired
    namestringYes

    Returns CreatedProject

    interface CreatedProject {
      /** The g-p-… id getProject and listProjects use. */
      id: string;
      name: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/createProject

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.createProject("<name>");
  • deleteConversationDeletes one of the CALLER's conversations.

    Arguments

    NameTypeRequired
    conversationstringYes

    Returns WriteResult

    interface WriteResult {
      ok: boolean;
      /** The conversation, memory or share id the write acted on. */
      id: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/deleteConversation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.deleteConversation("<conversation>");
  • deleteMemoryDeletes one saved memory from the CALLER's ChatGPT memory.

    Arguments

    NameTypeRequired
    memoryIdstringYes

    Returns WriteResult

    interface WriteResult {
      ok: boolean;
      /** The conversation, memory or share id the write acted on. */
      id: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/deleteMemory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.deleteMemory("<memoryId>");
  • generateImageAsks ChatGPT to create an image from a prompt as the CALLER and returns the image url(s) and the conversation they landed in.

    Arguments

    NameTypeRequired
    promptstringYes

    Returns GeneratedImages

    interface GeneratedImages {
      conversationId: string | null;
      /** One entry per picture; url is a short-lived download link. */
      images: { fileId: string; url: string | null }[];
      reply: string;
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/generateImage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.generateImage("<prompt>");
  • moveConversationToProjectFiles one of the CALLER's conversations under one of their projects.

    Arguments

    NameTypeRequired
    conversationstringYes
    projectstringYes

    Returns WriteResult

    interface WriteResult {
      ok: boolean;
      /** The conversation, memory or share id the write acted on. */
      id: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/moveConversationToProject

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.moveConversationToProject("<conversation>", "<project>");
  • pinGPTPins a GPT to (or unpins it from) the CALLER's sidebar.

    Arguments

    NameTypeRequired
    gptstringYes

    Returns WriteResult

    interface WriteResult {
      ok: boolean;
      /** The conversation, memory or share id the write acted on. */
      id: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/pinGPT

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.pinGPT("<gpt>");
  • rateResponseGives a thumbs up or thumbs down on one of ChatGPT's replies in the CALLER's conversation, the way the buttons under a reply do.

    Arguments

    NameTypeRequired
    conversationstringYes
    messageIdstringYes
    rating"thumbsUp" | "thumbsDown"Yes

    Returns WriteResult

    interface WriteResult {
      ok: boolean;
      /** The conversation, memory or share id the write acted on. */
      id: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/rateResponse

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.rateResponse("<conversation>", "<messageId>", "thumbsUp");
  • renameConversationRenames one of the CALLER's conversations.

    Arguments

    NameTypeRequired
    conversationstringYes
    titlestringYes

    Returns WriteResult

    interface WriteResult {
      ok: boolean;
      /** The conversation, memory or share id the write acted on. */
      id: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/renameConversation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.renameConversation("<conversation>", "<title>");
  • requestDataExportRequests an export of the CALLER's ChatGPT data (Settings → Data controls → Export); OpenAI emails the download link to the caller's own address.

    Arguments

    None.

    Returns WriteResult

    interface WriteResult {
      ok: boolean;
      /** The conversation, memory or share id the write acted on. */
      id: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/requestDataExport

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.requestDataExport();
  • sendMessageSends a message as the CALLER and returns ChatGPT's reply.

    Arguments

    NameTypeRequired
    textstringYes
    opts{ conversation?: string; parentMessageId?: string; model?: string; gpt?: string; temporary?: boolean }No

    Returns SentMessage

    interface SentMessage {
      conversationId: string | null;
      /** The assistant's message id, pass it back as parentMessageId or to rateResponse. */
      messageId: string | null;
      reply: string;
      model: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/sendMessage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.sendMessage("<text>");
  • shareConversationCreates a public share link for one of the CALLER's conversations and returns the chatgpt.com/share/ url.

    Arguments

    NameTypeRequired
    conversationstringYes

    Returns ShareLink

    interface ShareLink {
      shareId: string;
      /** chatgpt.com/share/<id>, readable by getSharedConversation. */
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/shareConversation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.shareConversation("<conversation>");
  • updateCustomInstructionsUpdates the CALLER's personalization.

    Arguments

    NameTypeRequired
    update{ aboutUser?: string; responseStyle?: string; enabled?: boolean }Yes

    Returns WriteResult

    interface WriteResult {
      ok: boolean;
      /** The conversation, memory or share id the write acted on. */
      id: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/updateCustomInstructions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.updateCustomInstructions({});
  • uploadFileUploads a text file to the CALLER's own ChatGPT file library and returns its file id.

    Arguments

    NameTypeRequired
    namestringYes
    contentstringYes
    opts{ contentType?: string }No

    Returns UploadedFile

    interface UploadedFile {
      /** The file-… id of the upload. */
      fileId: string;
      name: string;
      size: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/chatgpt/uploadFile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.chatgpt.uploadFile("<name>", "<content>");

Use it from code