MCP server
The Marqly MCP server lets any AI tool that supports the Model Context Protocol search, read and — if you allow it — organize your bookmarks.
ProServer address
https://mcp.marqly.com/ai/mcp
Transport: Streamable HTTP. Authentication: OAuth 2.1 with PKCE. Clients register themselves automatically; on first connection your browser opens a Marqly consent screen.
Read-only by default
When you approve a connection, the app can search and read your library. It cannot change anything until you turn on "Allow this app to change my library" — either on the consent screen or later in Settings → Connected apps. You can turn it off again, or revoke the app entirely, at any time. Every action an app takes is logged.
Supported clients
| Client | How to connect |
|---|---|
| Claude (claude.ai, Desktop, Claude Code) | Settings → Connectors → Add custom connector → paste the server address |
| ChatGPT (Plus, Pro, Business, Enterprise, Edu) | Settings → Connectors → Create → paste the server address. Deep research uses the search and fetch tools. |
| Cursor | Settings → MCP → Add new global MCP server: { "url": "https://mcp.marqly.com/ai/mcp" } |
| VS Code (GitHub Copilot) | Command palette → MCP: Add Server → HTTP → paste the server address |
| Windsurf | Settings → MCP → Add server (HTTP) |
| Zed and other stdio-only clients | Use the mcp-remote bridge below |
Other MCP clients
Any client that can run a local command can use the mcp-remote bridge:
Command: npx
Arguments: -y mcp-remote https://mcp.marqly.com/ai/mcp
Environment: none
On first run a browser window opens for the Marqly consent screen. On Windows under WSL, run the command from the same environment your client runs in; a browser that cannot open from inside WSL is the usual cause of a stalled sign-in — copy the printed URL into a Windows browser instead.
Available tools
Read-only tools only fetch data; the rest change your library and require write access to be enabled for the connection. Every change a connected app makes runs as an assistant action: it is applied at once, listed in Settings → AI Assistant → Activity, and can be undone there for 30 days.
Bookmarks
| Tool | What it does | Read-only |
|---|---|---|
find_bookmarks | Semantic + keyword search with filters (board, tags, type, dates, link status); lists newest first without a query | Yes |
fetch_bookmark_content | Page text of one bookmark — summary, full text (paged), or indexed passages | Yes |
find_duplicate_bookmarks | Bookmarks saved more than once | Yes |
find_broken_links | Bookmarks whose link check failed | Yes |
create_bookmarks | Save one or many URLs | |
update_bookmarks | Edit title/notes, add/remove/replace tags, move between boards | |
delete_bookmarks | Move to Trash (never permanent) |
Boards
| Tool | What it does | Read-only |
|---|---|---|
find_boards | List boards with counts, filter by name | Yes |
create_boards | Create boards, optionally nested | |
update_boards | Rename, describe, change emoji, move under another board | |
merge_boards | Merge boards into one | |
delete_boards | Delete boards; bookmarks left with no board go to Trash |
Tags
| Tool | What it does | Read-only |
|---|---|---|
find_tags | Tags with counts | Yes |
rename_tag | Rename across the library | |
merge_tags | Merge several tags into one | |
delete_tags | Remove tags from every bookmark |
Highlights
| Tool | What it does | Read-only |
|---|---|---|
find_highlights | Your text highlights, optionally within one bookmark | Yes |
create_highlight | Add a highlight to a bookmark | |
update_highlight | Edit a highlight's text or colour | |
delete_highlights | Delete highlights |
Account
| Tool | What it does | Read-only |
|---|---|---|
fetch_current_user | Your plan and library statistics | Yes |
search_help | Search Marqly's help center — how sharing, boards, the extension, import/export, billing and the AI features work; returns article links | Yes |
ChatGPT additionally sees search and fetch, which are aliases of find_bookmarks and fetch_bookmark_content in the shape ChatGPT's connectors expect.
Privacy
The MCP server runs on Marqly's own servers. Your data is never shared with third parties or used for training. An AI tool only receives what its tools return for the request you made; page text is passed to it as data, not instructions. See the privacy policy.
Limitations
- New bookmarks are searchable by title, URL and tags immediately; page content takes a few minutes to index.
- Responses depend on the AI tool you use — verify anything critical.
- Connections are per Marqly account. Revoking a connection signs that app out everywhere.
FAQ
Why am I seeing an error when trying to connect?
Make sure you are on Marqly Pro, that the address is exactly https://mcp.marqly.com/ai/mcp, and that your client supports OAuth for remote MCP servers. If it does not, use the mcp-remote bridge above.
The app says it is read-only. Open Settings → Connected apps in Marqly, find the app, and turn on Allow this app to change my library.
Does the MCP server support Streamable HTTP? Yes — it is the only transport. Legacy HTTP+SSE is not supported.
Can I authenticate with an API key instead of OAuth? No. OAuth is what lets you scope and revoke each connection separately.
I revoked an app but it still shows as connected in the client. The client keeps its own record; the next request it makes will fail and prompt you to reconnect.
What redirect URIs does the server accept?
Any HTTPS URL, HTTP loopback addresses (127.0.0.1, localhost, [::1] on any port), and private-use app schemes such as cursor://, vscode://, claude://, windsurf:// and zed://. That covers every client above; if yours uses something else, connect it through npx -y mcp-remote https://mcp.marqly.com/ai/mcp instead.