Claude MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Claude: 34 typed functions through one MCP server. No Claude API key needed.
- Site
- claude.ai
- Functions
- 34
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Claude 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/claudeOne MCP server for Claude and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth 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.
getAccountReads the CALLER's own Claude account.Arguments
None.
Returns
ClaudeAccountinterface ClaudeOrganization { id: string; name: string; } interface ClaudeAccount { id: string; email: string; fullName: string; organizations: ClaudeOrganization[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/getAccountCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.getAccount();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.getAccount())curl -X POST https://api.bowmark.ai/v1/sites/claude/getAccount \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.getAccount();getConversationReads one of the CALLER's Claude conversations.Arguments
Name Type Required conversationIdstringYes organizationIdstringNo Returns
ClaudeConversationinterface ClaudeSharedMessage { id: string; sender: string; text: string; createdAt: string; attachments: unknown[]; files: unknown[]; parentMessageId: string | null; } interface ClaudeConversationSummary { id: string; title: string; model: string | null; createdAt: string; updatedAt: string; starred: boolean; projectId: string | null; } interface ClaudeConversation extends ClaudeConversationSummary { summary: string; messages: ClaudeSharedMessage[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/getConversationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.getConversation({ conversationId: "00000000-0000-4000-8000-000000000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.getConversation({"conversationId": "00000000-0000-4000-8000-000000000000"}))curl -X POST https://api.bowmark.ai/v1/sites/claude/getConversation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"conversationId":"00000000-0000-4000-8000-000000000000"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.getConversation({ conversationId: "00000000-0000-4000-8000-000000000000" });getMemoryReads what Claude remembers about the CALLER (Settings → Capabilities → Memory), across chats or for one project.Arguments
Name Type Required organizationIdstringNo projectIdstringNo Returns
ClaudeMemoryinterface ClaudeMemory { organizationId: string; projectId: string | null; memory: Record<string, unknown>; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/getMemoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.getMemory();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.getMemory())curl -X POST https://api.bowmark.ai/v1/sites/claude/getMemory \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.getMemory();getPreferencesReads the CALLER's personal preferences.Arguments
None.
Returns
ClaudePreferencesinterface ClaudePreferences { profile: Record<string, unknown>; settings: Record<string, unknown>; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/getPreferencesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.getPreferences();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.getPreferences())curl -X POST https://api.bowmark.ai/v1/sites/claude/getPreferences \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.getPreferences();getProjectReads one of the CALLER's Claude projects.Arguments
Name Type Required projectIdstringYes organizationIdstringNo Returns
ClaudeProjectinterface ClaudeProjectSummary { id: string; name: string; description: string; starred: boolean; updatedAt: string; } interface ClaudeProjectDocument { id: string; filename: string; content: string; } interface ClaudeProjectFile { id: string; filename: string; size: number | null; createdAt: string; } interface ClaudeProject extends ClaudeProjectSummary { instructions: string; docs: ClaudeProjectDocument[]; files: ClaudeProjectFile[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/getProjectCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.getProject({ projectId: "00000000-0000-4000-8000-000000000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.getProject({"projectId": "00000000-0000-4000-8000-000000000000"}))curl -X POST https://api.bowmark.ai/v1/sites/claude/getProject \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"projectId":"00000000-0000-4000-8000-000000000000"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.getProject({ projectId: "00000000-0000-4000-8000-000000000000" });getPublishedArtifactReads a published Claude artifact from its public link (claude.ai/public/artifacts/<id>).Arguments
Name Type Required artifactIdstringYes Returns
ClaudePublishedArtifactinterface ClaudePublishedArtifact { id: string; title: string; description: string; language: string | null; type: string; content: string; viewCount: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/getPublishedArtifactCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.getPublishedArtifact("fcf36cd3-85f4-49f4-8ef1-5b767ff8ec55");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.getPublishedArtifact("fcf36cd3-85f4-49f4-8ef1-5b767ff8ec55"))curl -X POST https://api.bowmark.ai/v1/sites/claude/getPublishedArtifact \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"artifactId":"fcf36cd3-85f4-49f4-8ef1-5b767ff8ec55"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.getPublishedArtifact("fcf36cd3-85f4-49f4-8ef1-5b767ff8ec55");getUsageReads how much of the CALLER's Claude usage limit is spent and when it resets, the way Settings → Usage shows it.Arguments
Name Type Required organizationIdstringNo Returns
ClaudeUsageinterface ClaudeUsage { organizationId: string; usage: Record<string, unknown>; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/getUsageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.getUsage();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.getUsage())curl -X POST https://api.bowmark.ai/v1/sites/claude/getUsage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.getUsage();listArtifactsLists the artifacts the CALLER has made across their chats, with whether each is published.Arguments
Name Type Required organizationIdstringNo limitnumberNo Returns
ClaudeArtifactSummary[]interface ClaudeArtifactSummary { id: string; title: string; updatedAt: string; publishedArtifactId: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/listArtifactsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.listArtifacts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.listArtifacts())curl -X POST https://api.bowmark.ai/v1/sites/claude/listArtifacts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.listArtifacts();listConnectorsLists the connectors (MCP servers) the CALLER has added to Claude and whether each is connected.Arguments
Name Type Required organizationIdstringNo Returns
ClaudeConnector[]interface ClaudeConnector { id: string; name: string; connected: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/listConnectorsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.listConnectors();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.listConnectors())curl -X POST https://api.bowmark.ai/v1/sites/claude/listConnectors \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.listConnectors();listConversationsLists the CALLER's Claude chats, newest first.Arguments
Name Type Required organizationIdstringNo limitnumberNo offsetnumberNo Returns
ClaudeConversationSummary[]interface ClaudeConversationSummary { id: string; title: string; model: string | null; createdAt: string; updatedAt: string; starred: boolean; projectId: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/listConversationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.listConversations();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.listConversations())curl -X POST https://api.bowmark.ai/v1/sites/claude/listConversations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.listConversations();listModelsLists the Claude models the CALLER's plan can pick in the model selector.Arguments
Name Type Required organizationIdstringNo Returns
ClaudeModelOption[]interface ClaudeModelOption { id: string; displayName: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/listModelsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.listModels();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.listModels())curl -X POST https://api.bowmark.ai/v1/sites/claude/listModels \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.listModels();listProjectsLists the CALLER's Claude projects.Arguments
Name Type Required organizationIdstringNo Returns
ClaudeProjectSummary[]interface ClaudeProjectSummary { id: string; name: string; description: string; starred: boolean; updatedAt: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/listProjectsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.listProjects();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.listProjects())curl -X POST https://api.bowmark.ai/v1/sites/claude/listProjects \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.listProjects();listSkillsLists the skills enabled in the CALLER's Claude account, their own and Anthropic's.Arguments
Name Type Required organizationIdstringNo Returns
ClaudeSkill[]interface ClaudeSkill { id: string; name: string; enabled: boolean; builtIn: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/listSkillsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.listSkills();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.listSkills())curl -X POST https://api.bowmark.ai/v1/sites/claude/listSkills \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.listSkills();searchConversationsSearches the CALLER's Claude chat history by keyword, the way the sidebar search does, and returns the matching conversations.Arguments
Name Type Required querystringYes organizationIdstringNo limitnumberNo Returns
ClaudeConversationSummary[]interface ClaudeConversationSummary { id: string; title: string; model: string | null; createdAt: string; updatedAt: string; starred: boolean; projectId: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/searchConversationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.searchConversations({ query: "hello" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.searchConversations({"query": "hello"}))curl -X POST https://api.bowmark.ai/v1/sites/claude/searchConversations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"hello"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.searchConversations({ query: "hello" });
addProjectDocumentAdds a text document to one of the CALLER's project knowledge bases.Arguments
Name Type Required projectIdstringYes fileNamestringYes contentstringYes organizationIdstringNo Returns
ClaudeAddedProjectDocumentinterface ClaudeAddedProjectDocument { projectId: string; documentId: string; fileName: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/addProjectDocumentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.addProjectDocument({ projectId: "<projectId>", fileName: "<fileName>", content: "<content>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.addProjectDocument({ "projectId": "<projectId>", "fileName": "<fileName>", "content": "<content>" }))curl -X POST https://api.bowmark.ai/v1/sites/claude/addProjectDocument \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"projectId":"<projectId>","fileName":"<fileName>","content":"<content>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.addProjectDocument({ projectId: "<projectId>", fileName: "<fileName>", content: "<content>" });createProjectCreates a Claude project in the CALLER's account, private to them, with a name and description.Arguments
Name Type Required namestringYes descriptionstringNo organizationIdstringNo Returns
ClaudeCreatedProjectinterface ClaudeCreatedProject { projectId: string; name: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/createProjectCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.createProject({ name: "<name>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.createProject({"name": "<name>"}))curl -X POST https://api.bowmark.ai/v1/sites/claude/createProject \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"name":"<name>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.createProject({ name: "<name>" });deleteConversationDeletes one of the CALLER's Claude chats.Arguments
Name Type Required conversationIdstringYes organizationIdstringNo Returns
ClaudeConversationDeleteAckinterface ClaudeConversationDeleteAck { conversationId: string; ok: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/deleteConversationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.deleteConversation({ conversationId: "<conversationId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.deleteConversation({"conversationId": "<conversationId>"}))curl -X POST https://api.bowmark.ai/v1/sites/claude/deleteConversation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"conversationId":"<conversationId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.deleteConversation({ conversationId: "<conversationId>" });deleteProjectDocumentRemoves a document from one of the CALLER's project knowledge bases.Arguments
Name Type Required projectIdstringYes documentIdstringYes organizationIdstringNo Returns
ClaudeProjectDocumentDeleteAckinterface ClaudeProjectDocumentDeleteAck { projectId: string; documentId: string; ok: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/deleteProjectDocumentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.deleteProjectDocument({ projectId: "<projectId>", documentId: "<documentId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.deleteProjectDocument({"projectId": "<projectId>", "documentId": "<documentId>"}))curl -X POST https://api.bowmark.ai/v1/sites/claude/deleteProjectDocument \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"projectId":"<projectId>","documentId":"<documentId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.deleteProjectDocument({ projectId: "<projectId>", documentId: "<documentId>" });moveConversationToProjectMoves one or more of the CALLER's chats into a project, or out of one.Arguments
Name Type Required conversationIdstringYes projectIdstring | nullYes organizationIdstringNo Returns
ClaudeWriteAckinterface ClaudeWriteAck { conversationId: string; ok: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/moveConversationToProjectCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.moveConversationToProject({ conversationId: "<conversationId>", projectId: "<projectId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.moveConversationToProject({ "conversationId": "<conversationId>", "projectId": "<projectId>" }))curl -X POST https://api.bowmark.ai/v1/sites/claude/moveConversationToProject \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"conversationId":"<conversationId>","projectId":"<projectId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.moveConversationToProject({ conversationId: "<conversationId>", projectId: "<projectId>" });publishArtifactPublishes one of the CALLER's artifacts to a public claude.ai/public/artifacts link, or unpublishes it.Arguments
Name Type Required artifactIdstringTo publish: the artifact id from listArtifacts.No publishedArtifactIdstringTo unpublish: the published id (listArtifacts' publishedArtifactId) and published: false.No publishedbooleanDefault true.No organizationIdstringNo Returns
ClaudeArtifactPublishAckinterface ClaudeArtifactPublishAck { publishedArtifactId: string; published: boolean; /** The public claude.ai/public/artifacts link, or null after unpublishing. */ url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/publishArtifactCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.publishArtifact({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.publishArtifact({}))curl -X POST https://api.bowmark.ai/v1/sites/claude/publishArtifact \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.publishArtifact({});rateResponseGives a thumbs up or thumbs down, with an optional comment, on one of Claude's replies in the CALLER's conversation.Arguments
Name Type Required conversationIdstringYes messageIdstringYes rating"good" | "bad"Yes organizationIdstringNo Returns
ClaudeWriteAckinterface ClaudeWriteAck { conversationId: string; ok: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/rateResponseCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.rateResponse({ conversationId: "<conversationId>", messageId: "<messageId>", rating: "good" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.rateResponse({ "conversationId": "<conversationId>", "messageId": "<messageId>", "rating": "good" }))curl -X POST https://api.bowmark.ai/v1/sites/claude/rateResponse \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"conversationId":"<conversationId>","messageId":"<messageId>","rating":"good"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.rateResponse({ conversationId: "<conversationId>", messageId: "<messageId>", rating: "good" });renameConversationRenames one of the CALLER's Claude chats.Arguments
Name Type Required conversationIdstringYes namestringYes organizationIdstringNo Returns
ClaudeWriteAckinterface ClaudeWriteAck { conversationId: string; ok: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/renameConversationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.renameConversation({ conversationId: "<conversationId>", name: "<name>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.renameConversation({"conversationId": "<conversationId>", "name": "<name>"}))curl -X POST https://api.bowmark.ai/v1/sites/claude/renameConversation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"conversationId":"<conversationId>","name":"<name>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.renameConversation({ conversationId: "<conversationId>", name: "<name>" });sendMessageSends a message to Claude as the CALLER.Arguments
Name Type Required messagestringYes conversationIdstringNo projectIdstringNo modelstringNo organizationIdstringNo fileIdsstring[]File ids from uploadFile to attach to this message.No Returns
ClaudeReplyinterface ClaudeReply { conversationId: string; reply: string; stopReason: string | null; model: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/sendMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.sendMessage({ message: "<message>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.sendMessage({"message": "<message>"}))curl -X POST https://api.bowmark.ai/v1/sites/claude/sendMessage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"message":"<message>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.sendMessage({ message: "<message>" });starConversationStars or unstars one of the CALLER's Claude chats, which pins it at the top of the sidebar.Arguments
Name Type Required conversationIdstringYes starredbooleanYes organizationIdstringNo Returns
ClaudeWriteAckinterface ClaudeWriteAck { conversationId: string; ok: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/starConversationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.starConversation({ conversationId: "<conversationId>", starred: true });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.starConversation({"conversationId": "<conversationId>", "starred": True}))curl -X POST https://api.bowmark.ai/v1/sites/claude/starConversation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"conversationId":"<conversationId>","starred":true}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.starConversation({ conversationId: "<conversationId>", starred: true });updateMemoryTurns Claude's memory on or off for the CALLER, or tells it to forget everything (Settings → Capabilities → Memory).Arguments
Name Type Required enabledbooleanTurn memory on (true) or off (false).No resetbooleanMake Claude forget everything it remembers.No organizationIdstringNo Returns
ClaudeMemoryWriteAckinterface ClaudeMemoryWriteAck { organizationId: string; ok: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/updateMemoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.updateMemory({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.updateMemory({}))curl -X POST https://api.bowmark.ai/v1/sites/claude/updateMemory \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.updateMemory({});updatePreferencesUpdates the CALLER's personal preferences.Arguments
Name Type Required instructionsstringThe instructions Claude applies to every chat (Settings → Profile → personal preferences).Yes Returns
ClaudeSettingsAckinterface ClaudeSettingsAck { ok: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/updatePreferencesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.updatePreferences({ instructions: "<instructions>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.updatePreferences({"instructions": "<instructions>"}))curl -X POST https://api.bowmark.ai/v1/sites/claude/updatePreferences \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"instructions":"<instructions>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.updatePreferences({ instructions: "<instructions>" });updateProfileUpdates the CALLER's Claude profile.Arguments
Name Type Required fullNamestringThe caller's full name.No displayNamestringWhat Claude calls the caller.No Returns
ClaudeSettingsAckinterface ClaudeSettingsAck { ok: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/updateProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.updateProfile({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.updateProfile({}))curl -X POST https://api.bowmark.ai/v1/sites/claude/updateProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.updateProfile({});updateProjectInstructionsSets the custom instructions on one of the CALLER's projects.Arguments
Name Type Required projectIdstringYes instructionsstringYes organizationIdstringNo Returns
ClaudeProjectWriteAckinterface ClaudeProjectWriteAck { projectId: string; ok: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/updateProjectInstructionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.updateProjectInstructions({ projectId: "<projectId>", instructions: "<instructions>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.updateProjectInstructions({ "projectId": "<projectId>", "instructions": "<instructions>" }))curl -X POST https://api.bowmark.ai/v1/sites/claude/updateProjectInstructions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"projectId":"<projectId>","instructions":"<instructions>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.updateProjectInstructions({ projectId: "<projectId>", instructions: "<instructions>" });uploadFileUploads a file (PDF, image, text) to the CALLER's account so sendMessage can attach it.Arguments
Name Type Required fileNamestringThe file name Claude shows, e.g. "notes.txt".Yes textstringPlain-text content. Give this OR base64.No base64stringThe file's bytes, base64-encoded (a PDF, an image).No contentTypestringMIME type; defaults to text/plain for text, application/octet-stream otherwise.No organizationIdstringNo Returns
ClaudeUploadedFileinterface ClaudeUploadedFile { organizationId: string; fileId: string; fileName: string; raw: Record<string, unknown>; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/claude/uploadFileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.claude.uploadFile({ fileName: "<fileName>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.claude.uploadFile({"fileName": "<fileName>"}))curl -X POST https://api.bowmark.ai/v1/sites/claude/uploadFile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"fileName":"<fileName>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.claude.uploadFile({ fileName: "<fileName>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/claude/<function> - OpenAPI
/v1/sites/claude/openapi.json