How to integrate Linkhut MCP with Codex

Connect Codex to Linkhut MCP. Add this article as a private bookmark, list all bookmarks tagged with 'research', and more using natural language, with authentication handled for you.

Linkhut logoLinkhut
Oauth2

Linkhut is a minimalist bookmarking platform for organizing and sharing links with your team. It helps you keep references tidy, searchable, and collaborative in one place.

4 Tools

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With the Linkhut MCP integration, Codex can add and delete bookmarks, fetch your saved links, and list your tags, all without leaving the terminal or the app, whichever you prefer.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Linkhut with

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1700+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Linkhut MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

Try it

Ask Codex for a Linkhut task. The first time, Composio asks you to connect your Linkhut account.

For example, ask it to:

  • "Add this article as a private bookmark"
  • "List all bookmarks tagged with 'research'"
  • "Update the note on your saved GitHub link"

What is the Linkhut MCP server, and what's possible with it?

The Linkhut MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Linkhut account. It provides structured and secure access to all your saved bookmarks, so your agent can organize, tag, retrieve, and manage your URLs and references exactly how you want.

  • Bookmark organization and retrieval: Effortlessly ask your agent to fetch, list, or filter all bookmarks, including details like tags, notes, and timestamps.
  • Automated link saving: Let your agent add new bookmarks for important websites, articles, or resources—tagged and noted for easy discovery later.
  • Tag management and insights: Have your agent pull a list of all used tags, track how often tags appear, and help you keep your bookmark library organized.
  • Bookmark editing and updates: Direct your agent to modify titles, descriptions, or tags for any saved link so your collection always stays current and relevant.
  • Bookmark cleanup and removal: Ask your agent to delete obsolete or unwanted bookmarks, keeping your Linkhut workspace clean and focused.

Conclusion

You've successfully integrated Linkhut with Codex using Composio's MCP server. Now you can interact with Linkhut directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for Linkhut operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1700+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various Linkhut operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
TOOLS

Supported Tools

Every Linkhut action and event your agent gets out of the box.

Add bookmark

Adds a bookmark to LinkHut with optional tags, notes, privacy and unread settings.

Delete bookmark

This tool allows users to delete a bookmark from their Linkhut account by providing the bookmark URL.

Get all tags

Retrieves a list of all tags and their usage counts for the authenticated user.

Get bookmarks

Retrieves Linkhut bookmarks filtered by tag, date or exact URL; without a date or URL, it returns bookmarks from the most recent bookmark date.

FAQ

Frequently asked questions

Start with Linkhut.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Linkhut tool your agent needs.Free to start.

Start building