# xmark

> xmark is a freemium MCP server for knowledge and memory. Chat with your saved X bookmarks and get answers that cite the original posts. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $5 a month
- **Platforms:** Web, Chrome extension, API, CLI
- **Website:** https://www.xmark.dev
- **MCP Registry name:** io.github.JCLVSH/xmark
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.xmark.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "xmark": {
      "url": "https://api.xmark.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/xmark
