MCP Directory

How to add Twitter MCP to Windsurf

Post tweets and search Twitter/X from Claude or any MCP client using your Twitter API keys. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

Windsurf config for Twitter MCP

npx -y @enescinar/twitter-mcp
{
  "mcpServers": {
    "twitter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@enescinar/twitter-mcp"
      ],
      "env": {
        "API_KEY": "<your-api-key>",
        "API_SECRET_KEY": "<your-api-secret-key>",
        "ACCESS_TOKEN": "<your-access-token>",
        "ACCESS_TOKEN_SECRET": "<your-access-token-secret>"
      }
    }
  }
}

Setup steps

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

Before you start

  • A Twitter/X developer account with an app created in the Developer Portal
  • Four credentials from that app: API key, API secret key, access token, access token secret (with write permission for posting)
  • Node.js with npx; an X API tier that includes the endpoints you need (search usually requires a paid tier)

What Twitter MCP can do in Windsurf

post_tweet

Post a new tweet as the authenticated account.

search_tweets

Search for tweets matching a query.

Security

The four credentials in your config can post as your account — use a dedicated X developer app with the narrowest permissions you can, and remember they sit in plain text in claude_desktop_config.json. The project has not seen a commit since July 2025, so factor in unpatched drift against X API changes.

Twitter MCP + Windsurf FAQ

Where is the Windsurf config file?

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

Is Twitter MCP safe to use with Windsurf?

The four credentials in your config can post as your account — use a dedicated X developer app with the narrowest permissions you can, and remember they sit in plain text in claude_desktop_config.json. The project has not seen a commit since July 2025, so factor in unpatched drift against X API changes.

Is twitter-mcp free to use?

The server is MIT-licensed and free, but the X API behind it is not: free-tier apps get only a small monthly posting quota and essentially no search access, so search_tweets usually requires the paid Basic tier or higher. Costs come from X, not the server.

Can it post threads, images, or read my timeline?

No — the README documents exactly two tools: post_tweet (plain-text tweets) and search_tweets. Threads, media uploads, DMs, timelines, and deletes are all out of scope; you would need a more full-featured X server for those.

Is the project still maintained?

Activity has stalled: the last commit was July 2025. It still works against the current X API as of this writing, but if X changes endpoints or auth, fixes would likely come from forks rather than upstream — worth knowing before building anything durable on it.

View repo Full Twitter MCP page