Connecting Claude to My X Bookmarks with MCP: A Walkthrough

You can let Claude search your X (Twitter) bookmarks through MCP. Birdfeeder runs an MCP server for your bookmark archive. You copy a server URL and a token from Birdfeeder's Settings, add them to Claude Desktop's config, and Claude can then search everything you've bookmarked.

I built the MCP tools into Birdfeeder a few weeks ago and kept meaning to use them myself. Today I sat down and wired it into Claude Desktop to see what it's like from the user side.

What you need

A Birdfeeder account with your X account connected. Bluesky, Mastodon and Nostr bookmarks work the same way.
Claude Desktop, or any other app that supports MCP.
Node.js, because Claude Desktop needs a small bridge called mcp-remote to talk to a server that uses a token.

How to connect Claude to your bookmarks

Open Settings in Birdfeeder and scroll to "MCP server". It shows your server URL and your API token.
Open Claude Desktop's claude_desktop_config.json.
Copy the config block from Birdfeeder's Settings into the mcpServers section. It already contains your URL and token.
Restart Claude Desktop.

After the restart, the Birdfeeder tools showed up in Claude. There's no OAuth screen and no second account. The token is the one Birdfeeder already had for your account, so there's nothing new to manage.

What I asked Claude about my bookmarks

The first question was simple, just to check it worked: "What have I bookmarked about Rust error handling?" Claude called the search tool, got back three bookmarks, and answered in plain language with the tweets quoted and linked. It answered from my actual bookmarks.

Then I asked which accounts I had bookmarked things from. Claude used the second tool, which lists the authors in my archive, and the list matched what I remembered.

Those are the two tools the server has today: search_bookmarks (search by words, by author, or both) and list_bookmark_authors. Search works the same way as the search page on the website.

Does it work without a subscription?

MCP access is the same as website search. On the 14-day trial or a paid plan, Claude can search your whole archive. Without a subscription, search only covers the last 7 days, so a question about something you saved three weeks ago comes back empty. I didn't give MCP a way around that on purpose. It would be strange if the assistant could see more of your data than you can on the website.

Does it only work with Claude?

No. MCP is an open protocol, so any MCP-compatible assistant can use the same server URL and token and get the same two tools. Later I used it with Hermes Agent to plan a trip from my own bookmarks. It also works for Bluesky and Mastodon bookmarks.

Birdfeeder costs $5 a month or $45 a year, with a 14-day trial and no card needed. The MCP server is included. More on the X MCP server page.