Skip to content
MCP server

xmark

Chat with your saved X bookmarks and get answers that cite the original posts

Status and history

Answered our latest tool-list check 21 hours ago with 11 tools. It will be marked verified after 3 successful checks in 7 days.

Pricing
Freemium
Platforms
Web, Chrome extension, API
Runs
Locally or Remotely
Version
0.7.3
Listing updated
2 days ago

About xmark

xmark is a freemium MCP server for knowledge and memory. It can run locally on your machine or as a hosted remote server.

xmark syncs bookmarks from your X account and indexes them with OpenAI embeddings in pgvector, so you can ask questions in your own words and get an answer from Claude with numbered citations back to the saved posts. Indexing covers quoted posts, image alt text and linked article metadata, not just post text.

Access to X is read-only through OAuth 2.0 with PKCE; the site says it never posts, messages or follows for you, and bookmarks stay on X. The free plan covers 20 chat messages a month and one sync a day of your newest 500 bookmarks. Pro is $5 a month or $50 a year, with unlimited chat and up to 10 syncs an hour of your newest 3,000 bookmarks.

Beyond the web app, a developer REST API with scoped keys, a CLI, a Chrome extension and this MCP server let agents search the same archive. The MCP server needs an xmark API key and runs over stdio or a hosted endpoint.

Install

Run in a terminal

claude mcp add --transport http xmark https://api.xmark.dev/mcp

Add to Settings → Connectors → Add custom connector

https://api.xmark.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "xmark": {
      "url": "https://api.xmark.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "xmark": {
      "type": "http",
      "url": "https://api.xmark.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "xmark": {
      "serverUrl": "https://api.xmark.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "xmark": {
      "type": "http",
      "url": "https://api.xmark.dev/mcp"
    }
  }
}

Configuration

  • XMARK_API_KEYYour xmark API key.Required
  • XMARK_API_URLOverride the API host.

Tools this server provides (11)

Read directly from the server.

list_bookmarks
List the authenticated user's X bookmarks. Paginated.
get_bookmark
Fetch a single bookmark by ID.
search_bookmarks
Semantic search over the user's bookmarks. Returns ranked matches with relevance scores.
sync_bookmarks
Trigger a fresh sync from X. Pulls latest bookmarks, embeds new ones for semantic search. Free tier allows one sync per day.
delete_bookmark
Remove a bookmark. Local-only by default — the next sync re-creates anything still bookmarked on X. Set unbookmark=true to also remove it on X (sticks across syncs; requires a connected X account).
chat
Ask a natural-language question about the user's X bookmarks. Returns an answer with citations back to the original tweets. Free tier includes 20 chat messages per month.
list_conversations
List the user's past chat conversations. Paginated.
get_conversation_messages
A conversation's message history, oldest first. Assistant messages carry the IDs of the bookmarks retrieved for that answer.
delete_conversation
Permanently delete a conversation and its messages. Free tier allows one concurrent conversation, so deleting is how a free account starts a fresh chat.
get_usage
The authenticated user's plan and quota usage: chat messages this month, syncs today, bookmark count, and whether an X account is connected. Limits are null on unlimited plans.
get_changelog
machine-readable release history (public) - version, date, type, summary, migration notes on breaking entries. the X-Notice header's structured backstory.

What it does

Semantic search
Find posts by meaning rather than exact wording.
Cited chat
Answers link back to the original posts.
Read-only X access
OAuth with PKCE; never posts for you.
Full-content indexing
Includes quotes, alt text and article metadata.
Developer access
REST API, CLI, Chrome extension and MCP.
Import options
Guides cover Pocket, Readwise or CSV imports.

Good for

  • Find a thread you saved months ago about a tool
  • Summarise what you have bookmarked on a topic
  • Feed bookmarks into an agent or note pipeline
  • Build a research library from saved posts

Pricing

Freemium, from $5 a month

Free plan; Pro $5/month or $50/year

Prices change. Check xmark.dev before you buy.

xmark FAQ

How much does it cost?

Free covers 20 chat messages a month; Pro is $5 a month or $50 a year.

Can it post to my X account?

No. Access is read-only and it never posts, DMs or follows.

How many bookmarks sync?

Free syncs your newest 500 once a day; Pro syncs up to 3,000 newest, up to 10 times an hour.

What do I need for the MCP server?

An xmark API key, set as XMARK_API_KEY.

Is xmark free?

xmark has a free plan, with paid plans for more usage or features. Paid plans start at $5 a month.

How do I add xmark to Claude Code?

Run this command in your terminal: claude mcp add --transport http xmark https://api.xmark.dev/mcp

What are the best alternatives to xmark?

The closest alternatives to xmark are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

Alternatives to xmark

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity