> For the complete documentation index, see [llms.txt](https://being-and-time.gitbook.io/poqrr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://being-and-time.gitbook.io/poqrr/advanced/mcp-connections.md).

# MCP Connections

Connect an external AI assistant to Booby so you can send something from a conversation into your PoQrr Life Archive as a Memo.

In a connected conversation, ask:

> Call Booby with this: “String should sort PoQs by Response time rather than Event time.”

The assistant calls Booby with the selected content. Booby saves a Memo in the PoQrr account you authorized. It does not create a PoQ or schedule a reminder.

## Availability

MCP connections are currently in development testing and restricted to enabled PoQrr accounts. A publicly reachable server URL does not mean access is open to every account.

Grok on grok.com has been tested successfully. Other assistants need support for custom remote MCP servers and compatible OAuth authentication; they have not yet been verified with Booby. Mentioning `@grok` in a public post on X is not a verified way to use this connection.

## Connection Details

| Setting        | Value                            |
| -------------- | -------------------------------- |
| Server name    | Booby                            |
| Server URL     | `https://mcp.poqrr.com/mcp`      |
| Transport      | Streamable HTTP                  |
| Authentication | OAuth through your PoQrr account |
| Permission     | Create Memos (`memo:create`)     |

Use the same server URL for supported clients. You do not need a client-specific endpoint or a manually supplied bearer token for the OAuth setup.

## Connect From Grok

1. Open [Grok Connectors](https://grok.com/connectors).
2. Choose **New Connector**, then **Custom**.
3. Enter **Booby** as the name, if requested, and `https://mcp.poqrr.com/mcp` as the server URL.
4. Start the connection and sign in to PoQrr if needed. If sign-in opens a separate tab, return to the consent page afterward.
5. Check the PoQrr account and requesting client shown on the consent page, then choose **Allow Memo creation**.
6. Let the popup return to Grok and finish connecting.

In a Grok conversation with the connector enabled, try:

> Call Booby with this: “Hello from Grok. This is my first Memo.”

After the tool succeeds, check your PoQrr Life Archive. The returned Memo ID identifies the saved record. Grok's setup instructions are also available in its [connector documentation](https://docs.x.ai/grok/connectors).

## What “This” Means

The external assistant owns the conversation context. When you say “Call Booby with this,” that assistant resolves what you mean and sends the intended content.

Booby receives the submitted content and an optional title. It does not receive the whole conversation or gain access to your chat history. If the intended content is unclear, the assistant should ask before sending it.

For exact wording, say so explicitly:

> Call Booby with the following text, exactly as written: “Keep the original wording.”

A title is optional. The assistant does not need to invent one.

## Source Labels

Memos saved through this connection retain MCP ingest metadata and, when available, the requesting OAuth client's ID and name. In the Archive and Memo view, the label appears as **Via Grok**, or **Via MCP** when a client name is unavailable.

The source label is separate from the Memo content. Client names are supplied by client registrations; they are attribution, not verified identity. A connection does not automatically provide an original conversation or post URL.

## Access And Boundaries

The current connection exposes one tool: `call_booby`. It can create a Memo in the authorized account. It cannot read or search your Archive, access Nest-protected content, create PoQs, or sync a conversation.

The Memo remains a Memo. Organizing it or using its material in a PoQ is a separate action.

## Troubleshooting

* **Account not allowed:** development access is restricted. Check that you signed in to the intended PoQrr account and that the account has been enabled.
* **Missing or expired consent session:** close the old authorization popup and start a new connection from the assistant. Approval links are short-lived and single-use; submitting the old form again will not restart authorization.
* **Callback error or stuck popup:** start a fresh connection once. If it still fails, report the error text and the page's domain and path. Omit query parameters, which may contain temporary authorization codes.
* **Uncertain save result:** check your Archive before asking the assistant to retry. Repeating a save can create another Memo.

## Tool Reference

The assistant calls `call_booby` with:

```json
{
  "content": "The text the user wants to send to Booby.",
  "title": "Optional title"
}
```

`content` is required and must be nonblank, with a maximum of 20,000 characters. `title` is optional; if supplied, it must be nonblank and no longer than 300 characters. Do not send account IDs, source labels, or PoQ fields as tool inputs. Account ownership and client attribution are attached by the server.

A successful response contains:

```json
{
  "memo_id": "784d66bd-c7b0-4175-a2c0-3f388db1c806",
  "saved_at": "2026-10-25T21:26:21.213Z"
}
```

The values above illustrate the response format. Each new Memo receives its own ID and creation timestamp.