Skip to main content
Glama

Read my messages

event_inbox
Read-onlyIdempotent

Reads the person's own conversations with people they connected with at an event. Needs a personal connector token; a shared token reaches no conversations. With no arguments it lists up to twenty threads, person-to-person ones first: each row carries the other person's first name, the last line, when it landed, whether that line was the person's own, and how many are unread. With firstName or chatId it returns the last lines of that one conversation, oldest first, each saying whether it was theirs, what it said and when. No row carries a phone number, email address, surname, account id or photo. It reads only the caller's own conversations, checked on every call: a conversation they are not in returns NOT_PARTICIPANT. A firstName is matched against their own threads only: two matches return AMBIGUOUS_NAME and name neither, and no match returns NAME_NOT_IN_THREADS. Reading a conversation marks it read for that person, as opening it in the app or on the web does.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoOptional. How many lines of one conversation to return, at most 50; 30 when absent. Not used when listing threads, which returns at most 20.
chatIdNoOptional. The id of one conversation, as a thread row from this tool gave it. When both this and firstName are sent, this one is used.
firstNameNoOptional. The first name of the person whose conversation to read, as a thread row spelled it, matched against the caller's own conversations only. Two matches return AMBIGUOUS_NAME and nothing is read.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
okNo
errorNo
chatIdNo
unreadNo
messageNo
threadsNo
messagesNo
returnedNo
servedByNo
candidatesNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": true,
      +  "anyOf": [
      +    {
      +      "required": [
      +        "ok",
      +        "returned"
      +      ]
      +    },
      +    {
      +      "properties": {
      +        "ok": {
      +          "const": false
      +        }
      +      },
      +      "required": [
      +        "ok"
      +      ]
      +    },
      +    {
      +      "properties": {
      +        "found": {
      +          "const": false
      +        }
      +      },
      +      "required": [
      +        "found"
      +      ]
      +    },
      +    {
      +      "required": [
      +        "error"
      +      ]
      +    }
      +  ],
      +  "properties": {
      +    "candidates": {
      +      "items": {
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "chatId": {
      +      "type": "string"
      +    },
      +    "error": {
      +      "type": "string"
      +    },
      +    "message": {
      +      "type": "string"
      +    },
      +    "messages": {
      +      "items": {
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "ok": {
      +      "type": "boolean"
      +    },
      +    "returned": {
      +      "type": "integer"
      +    },
      +    "servedBy": {
      +      "type": "string"
      +    },
      +    "threads": {
      +      "items": {
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "unread": {
      +      "type": "integer"
      +    }
      +  },
      +  "type": "object"
      +}
  2. Changed3 schema fields changed
    • changedInput schema / properties / chatId / description
      Previous value: -"OPTIONAL. The id of one conversation, exactly as a thread row from this same tool gave it. Never construct one. Pass this OR firstName, not both; passing both uses this one."New value: +"Optional. The id of one conversation, as a thread row from this tool gave it. When both this and firstName are sent, this one is used."
    • changedInput schema / properties / firstName / description
      Previous value: -"OPTIONAL. The FIRST NAME of the person whose conversation to read, exactly as a thread row spelled it. Matched against the caller's OWN conversations only. If two of them answer to it the reply is AMBIGUOUS_NAME and nothing is read, and you ask which one they mean rather than choosing."New value: +"Optional. The first name of the person whose conversation to read, as a thread row spelled it, matched against the caller's own conversations only. Two matches return AMBIGUOUS_NAME and nothing is read."
    • changedInput schema / properties / limit / description
      Previous value: -"OPTIONAL. How many lines of one conversation to return, at most 50. Omit for the last 30. Ignored when listing threads, which is always at most 20."New value: +"Optional. How many lines of one conversation to return, at most 50; 30 when absent. Not used when listing threads, which returns at most 20."
  3. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources