getUserTimeline

Retrieve recent tweets from a specific user's timeline, including optional fields like author details, metrics, and media attachments, using the Twitter MCP Server.

Instructions

Get recent tweets from a user timeline

Input Schema

Name	Required	Description
`expansions`	No	Additional fields to expand in the response
`maxResults`	No	Maximum number of results to return
`tweetFields`	No	Fields to include in the tweet objects
`userFields`	No	User fields to include in the response
`userId`	Yes	The ID of the user

Input Schema (JSON Schema)

{
  "properties": {
    "expansions": {
      "description": "Additional fields to expand in the response",
      "items": {
        "enum": [
          "author_id",
          "referenced_tweets.id",
          "in_reply_to_user_id",
          "attachments.media_keys"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "maxResults": {
      "description": "Maximum number of results to return",
      "type": "number"
    },
    "tweetFields": {
      "description": "Fields to include in the tweet objects",
      "items": {
        "enum": [
          "created_at",
          "author_id",
          "conversation_id",
          "public_metrics",
          "entities",
          "context_annotations"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "userFields": {
      "description": "User fields to include in the response",
      "items": {
        "enum": [
          "username",
          "name",
          "profile_image_url",
          "verified"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "userId": {
      "description": "The ID of the user",
      "type": "string"
    }
  },
  "required": [
    "userId"
  ],
  "type": "object"
}

Twitter MCP Server

getUserTimeline

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Twitter MCP Server

Related Tools