How to add MCP-Twikit to Windsurf

Search Twitter/X and read your home timeline from an MCP client, using the twikit library. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 235★ · stdio · apikey

Windsurf config for MCP-Twikit

npx -y @smithery/cli install mcp-twikit --client claude

{
  "mcpServers": {
    "mcp-twikit": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/adhikasp/mcp-twikit",
        "mcp-twikit"
      ],
      "env": {
        "TWITTER_USERNAME": "@example",
        "TWITTER_EMAIL": "me@example.com",
        "TWITTER_PASSWORD": "secret"
      }
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the MCP-Twikit config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5MCP-Twikit's tools become available to Cascade.

Before you start

uv / uvx (to run the server from the GitHub repo)
A Twitter account (username, email, and password supplied as environment variables)

What MCP-Twikit can do in Windsurf

search_twitter

Search Twitter for tweets matching a query. Demonstrated with arguments query (e.g. 'to:IndiHomeCare'), count (number of tweets), and sort_by (e.g. 'Latest').

get_timeline

Retrieve the latest tweets from the authenticated user's home timeline.

Security

Authenticates by logging in with your real Twitter account credentials (TWITTER_USERNAME, TWITTER_EMAIL, TWITTER_PASSWORD) supplied as environment variables, rather than an official API token. Storing and using account credentials this way carries account-security and Twitter terms-of-service risk; use a dedicated/secondary account and keep credentials out of source control.

MCP-Twikit + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the MCP-Twikit config there under the "mcpServers" key and restart the client.

Is MCP-Twikit safe to use with Windsurf?

Does this require the official Twitter API?

No. It uses the twikit library and logs in with your own Twitter account credentials (username, email, password) provided as environment variables.

How do I install it?

Automatically via Smithery (`npx -y @smithery/cli install mcp-twikit --client claude`), or manually by adding the provided config that runs `uvx --from git+https://github.com/adhikasp/mcp-twikit mcp-twikit` with your Twitter credentials in env.

What tools does it expose?

The documented tools are search_twitter (search for tweets by query, count, and sort order) and get_timeline (read your home timeline).

View repo Full MCP-Twikit page