Use your hectors.ai conversations from Claude Desktop and other MCP-compatible clients. Create, search, and manage conversations without leaving your tools.
Create conversations
Start a new conversation in any mode (think, build, write, explore, summarize, or cook) right from Claude.
Search your history
Find past conversations by keyword, filter by mode, and pick up where you left off.
Add messages
Append user or assistant messages to any existing conversation.
View usage stats
See how many conversations you have, broken down by mode and activity.
Everything you do through MCP syncs instantly with the hectors.ai web app and CLI. Your conversations, modes, and history stay in one place.
Connect Claude Desktop directly to hectors.ai over the cloud. No local Node.js or terminal setup required.
https://hectors.ai/api/mcp
Configure Claude Desktop manually via its JSON configuration file using the standard `mcp-remote` proxy.
~/Library/Application Support/Claude/claude_desktop_config.jsonmcpServers section using the remote bridge:{
"mcpServers": {
"hectors-ai": {
"command": "npx",
"args": ["-y", "mcp-remote@latest", "https://hectors.ai/api/mcp"]
}
}
}We support two secure ways to connect Claude Desktop to your hectors.ai account:
Native OAuth (Option A)
Uses standard OAuth 2.1 with PKCE. Claude Desktop manages your credentials securely in the background using token discovery, redirecting to the official browser sign-in page.
Device Authorization (Option B)
Uses the OAuth 2.0 Device Code flow. The command-line script requests a verification URL and code on startup, and retrieves the secure session after you sign in in a browser.
Nothing stored on your machine
Your session is managed entirely on the hectors.ai cloud server. No sensitive credentials or master tokens are saved to disk. Sessions stay active while your client is running.
Read-only mode tools (list_modes, get_mode) are publicly available and can be run without signing in.
Once connected, these tools appear in your MCP client and can be called by you or by the AI assistant.
| Tool | What it does |
|---|---|
| Modes | |
list_modes | See all available conversation modes and their settings. |
get_mode | Get details about a specific mode (think, build, write, explore, summarize, cook). |
| Conversations | |
create_conversation | Start a new conversation. Choose a mode and optionally set a title or first message. |
get_conversation | Open a conversation by its ID to see its full message history. |
update_conversation | Rename a conversation or change its mode. |
delete_conversation | Permanently delete a conversation. |
list_conversations | Browse your conversations with optional mode filtering and pagination. |
search_conversations | Search your conversations by keyword or title. |
| Messages & Stats | |
add_message | Add a message to a conversation (as user, assistant, or system note). |
get_stats | View usage statistics: total conversations, breakdown by mode, recent activity. |
You don't need to write JSON to use these tools. Your MCP client handles the protocol. Just ask Claude naturally:
“Create a new conversation in build mode called ‘React Components’”
→ Calls create_conversation with mode "build" and title "React Components"
“Search my conversations for anything about TypeScript”
→ Calls search_conversations with query "TypeScript"
“Show me my usage stats”
→ Calls get_stats and presents a summary
“List all my recent build conversations”
→ Calls list_conversations with mode "build"
Reach out to us at Support and we'll help you get connected.