opentwitter-mcp-server — Claude Code skill: what it does
opentwitter-mcp-server wires an MCP server for Twitter/X into your assistant: account lookups, keyword search, follower changes, deleted posts. Needs a token from 6551.io.
no license 212 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill opentwitter-mcp-server -a claude-codeWhat opentwitter-mcp-server does
The skill drops a SKILL.md into your project that tells the agent how to bring up the opentwitter-mcp server and which tools it exposes. The server itself runs on uv and talks to the 6551.io API. Once it is registered, the assistant can look up an account by handle or numeric ID, read an author's recent posts, and open a thread with its replies and quotes.
Thirteen tools in total. Search comes in two versions: a plain keyword call, and an advanced one where you set like and retweet floors, language, and date bounds. A separate group watches accounts for new followers, unfollows, and deleted posts. Watch lists sit on the service side, so adding or removing an account happens from the chat.
You need a 6551.io token in TWITTER_TOKEN plus uv installed. The server will not start without that token; the rest of the settings are optional. TWITTER_API_BASE swaps the API host, which defaults to https://ai.6551.io, and TWITTER_MAX_ROWS caps results per query at 100 by default. A config.json in the project root works instead of environment variables.
What it helps with
- pull an account profile by handle
- search posts by keyword with a like floor
- catch who unfollowed a tracked account
- list influential followers of an account
- check which posts an author deleted
Example prompts for the agent
- Show me @VitalikButerin's profile and his last 20 posts
- Search for ETH posts with at least 1000 likes, English only
- Add @elonmusk to my watch list with NEW_FOLLOWER and NEW_UNFOLLOWER events
How to install opentwitter-mcp-server
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill opentwitter-mcp-server -a claude-code2Manually: put the files in place
~/.claude/skills/opentwitter-mcp-server/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/opentwitter-mcp-server/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill opentwitter-mcp-server -a codex2Manually: put the files in place
.agents/skills/opentwitter-mcp-server/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill opentwitter-mcp-server -a cursor2Manually: put the files in place
.cursor/skills/opentwitter-mcp-server/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/opentwitter-mcp-server2Manually: put the files in place
.github/skills/opentwitter-mcp-server/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill opentwitter-mcp-server -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/opentwitter-mcp-serverManually: put the files in place
.devin/skills/opentwitter-mcp-server/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill opentwitter-mcp-server -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about opentwitter-mcp-server
How do I install opentwitter-mcp-server in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill opentwitter-mcp-server -a claude-code. The skill file then sits at ~/.claude/skills/opentwitter-mcp-server/SKILL.md.
What does opentwitter-mcp-server do?
It gives the assistant Twitter/X data through the opentwitter-mcp server: profiles, posts, filtered search, follower events, and a watch list of accounts.
What do I need before it works?
A 6551.io token in TWITTER_TOKEN, uv installed, and the repository path passed to --directory. The API host can be changed with TWITTER_API_BASE.