Macro

https://docs.macro.com
Admin
Macro is a fast, unified workspace that integrates email, messaging, tasks, docs, and files into a...
Tokens:13,701
Snippets:253
Trust Score:9.2
Update:2 months ago
Show doc for...
Tokens:
Raw
### Import Notion docs via Agent

Source: https://docs.macro.com/switch-to-macro

Use the agent chat to trigger a migration of Notion pages into Macro documents while preserving folder structure.

```text
Import my Notion docs from the "Engineering" workspace as Macro docs.
Keep the folder structure and skip anything archived.
```

--------------------------------

### Import ClickUp Documents via Agent

Source: https://docs.macro.com/switch-to-macro

Use this prompt in an agent chat to automate the migration of documents from a specific ClickUp space while maintaining folder structure.

```text
Import my ClickUp Docs from the "Engineering" space as Macro docs.
Keep the folder structure and skip anything archived.
```

--------------------------------

### Import data from external tools

Source: https://docs.macro.com/AI/recipes

Use this prompt after connecting a tool in Settings to migrate content into Macro.

```text
Import my Notion docs from the "Engineering" workspace as Macro
docs. Keep the folder structure and skip anything archived.
```

--------------------------------

### Configure Macro MCP in IDEs

Source: https://docs.macro.com/AI/mcp/overview

JSON configuration snippet for editors that support MCP server integration.

```json
{
  "macro": {
    "type": "http",
    "url": "https://mcp-server.macro.com/mcp"
  }
}
```

--------------------------------

### web_fetch

Source: https://docs.macro.com/AI/mcp/tools/web-fetch

Fetches content from a specified URL.

```APIDOC
## web_fetch

### Description
Fetches the content from a provided URL.

### Parameters
#### Arguments
- **url** (string) - Required - The URL to fetch content from.
```

--------------------------------

### Request project status updates

Source: https://docs.macro.com/AI/recipes

Use this prompt in an agent chat to synthesize recent tasks, discussions, and transcripts for a specific project.

```text
What's the latest status of [project]? Check recent tasks, channel
discussion, and call transcripts, and tell me what changed this week
and what's blocking.
```

--------------------------------

### Create a daily inbox brief automation

Source: https://docs.macro.com/AI/recipes

Use this prompt in an automation scheduled for weekday mornings to summarize Signal inbox activity.

```text
Every weekday at 8am: summarize what's in my Signal inbox.
Group it into: needs a reply today, FYI, and waiting on others.
Keep it under ten bullets.
```

--------------------------------

### ListEntities

Source: https://docs.macro.com/AI/mcp/tools/list-entities

Retrieves a list of entities from the Macro Rust tool registry based on specified types and sorting criteria.

```APIDOC
## ListEntities

### Description
Retrieves a list of entities from the Macro system. Supports filtering by entity type and sorting by various criteria.

### Parameters
#### Request Body
- **includeTypes** (array) - Required - Filter to specific item types. Example: ["document", "email"].
- **sortBy** (string) - Required - How to sort results: recently_viewed (default), recently_updated, or recently_created.
```

--------------------------------

### CreateDocument

Source: https://docs.macro.com/AI/mcp/tools/create-document

Creates a new document with the specified name, content, extension, and task status.

```APIDOC
## CreateDocument

### Description
Creates a new plaintext document in the system.

### Parameters
- **documentName** (string) - Required - The name of the document without the file extension
- **fileContent** (string) - Required - The string content of the document you are creating.
- **fileExtension** (string) - Required - The extension of the plaintext file you are creating.
- **isTask** (boolean) - Required - Whether this document is a task. Only applies to md documents.
```

--------------------------------

### Execute workspace tasks via Claude Code

Source: https://docs.macro.com/AI/recipes

Use these prompts when using the Macro MCP server to manage tasks and communications directly from your coding environment.

```text
Find the Macro task for the bug I'm fixing, read the linked channel
discussion, and when I'm done, set the task status to In Review and
post a summary of the fix as a comment.
```

```text
Read the customer thread about the export bug, then draft (don't
send) a reply explaining the fix that shipped in today's release.
```

--------------------------------

### Convert call transcripts to tasks

Source: https://docs.macro.com/AI/recipes

Use this prompt after a call to extract action items and create tasks assigned to the appropriate team members.

```text
Go through @[yesterday's planning call] and create a task for each
action item we committed to. Assign them to whoever took the item,
and link the call in each task.
```

--------------------------------

### web_search

Source: https://docs.macro.com/AI/mcp/tools/web-search

Executes a web search using the provided query string.

```APIDOC
## web_search

### Description
Performs a web search based on the provided query.

### Parameters
- **query** (string) - Required - The search term to query the web.
```

--------------------------------

### Generate a weekly team recap

Source: https://docs.macro.com/AI/recipes

Use this prompt in an automation scheduled for Friday afternoons to summarize team progress and decisions.

```text
Every Friday at 4pm: write a recap of the week for @#general:
tasks completed, tasks started, key decisions from calls, and
anything that slipped. Link to the relevant items.
```

--------------------------------

### bash_code_execution

Source: https://docs.macro.com/AI/mcp/tools/bash-code-execution

Executes a provided bash command string.

```APIDOC
## bash_code_execution

### Description
Executes a bash command on the system.

### Parameters
- **command** (string) - Required - The bash command to execute
```

--------------------------------

### Add Macro MCP to Codex CLI

Source: https://docs.macro.com/AI/mcp/overview

Command to register the Macro MCP server with the Codex CLI.

```bash
codex mcp add macro --url https://mcp-server.macro.com/mcp
```

--------------------------------

### Draft email replies

Source: https://docs.macro.com/AI/recipes

Use this prompt to generate a draft response to an email thread with specific tone and content instructions.

```text
Draft a reply to @[email thread]. Tone: warm but brief. We can do
the June 20 date, but ask them to send the revised scope first.
```

--------------------------------

### Summarize channel threads

Source: https://docs.macro.com/AI/recipes

Mention @Macro in a channel to summarize ongoing discussions and identify unanswered questions.

```text
@Macro summarize this thread for someone joining late, and list
the open questions nobody has answered yet.
```

--------------------------------

### ReadThread Tool

Source: https://docs.macro.com/AI/mcp/tools/read-thread

The ReadThread tool is used to retrieve content from the Macro platform. It requires a content type and specific IDs to fetch the requested data.

```APIDOC
## ReadThread

### Description
Retrieves content threads or messages based on the specified content type and identifiers.

### Parameters
- **contentType** (string) - Required - The type of content to read.
- **ids** (array) - Required - ID(s) of the content to read. Multiple IDs are supported for channel-message, chat-message, and content types; single ID required for others.
- **messagesSince** (string) - Required - A local datetime in ISO 8601 format representing the earliest message to include in a channel transcript.
```

--------------------------------

### SendEmail

Source: https://docs.macro.com/AI/mcp/tools/send-email

The SendEmail tool is used to dispatch emails. It supports specifying primary recipients, CC, BCC, subject, body, and optional thread reply IDs.

```APIDOC
## SendEmail

### Description
Sends an email with the specified content and recipients.

### Parameters
- **bcc** (array) - Required - Blind carbon copy recipients.
- **body** (string) - Required - The plain text body of the email.
- **cc** (array) - Required - Carbon copy recipients.
- **replyingToId** (string) - Required - The ID of a message to reply to. When set, the email is sent as a reply within the same thread.
- **subject** (string) - Required - The subject line of the email.
- **to** (array) - Required - The primary recipients (To field).
```

--------------------------------

### Add Macro MCP to Claude Code

Source: https://docs.macro.com/AI/mcp/overview

Command to register the Macro MCP server with the Claude Code CLI.

```bash
claude mcp add --transport http macro https://mcp-server.macro.com/mcp
```

--------------------------------

### Macro MCP Endpoint URL

Source: https://docs.macro.com/AI/mcp/overview

The remote URL required for connecting to the Macro MCP server.

```text
https://mcp-server.macro.com/mcp
```

--------------------------------

### text_editor_code_execution

Source: https://docs.macro.com/AI/mcp/tools/text-editor-code-execution

Executes file operations such as viewing, creating, or replacing text within a file.

```APIDOC
## text_editor_code_execution

### Description
Executes file operations including viewing, creating, or performing string replacements within a file.

### Parameters
- **command** (string) - Required - The command to execute: "view", "create", or "str_replace"
- **path** (string) - Required - Path to the file
- **file_text** (string) - Optional - File content for create operations
- **old_str** (string) - Optional - String to find for str_replace operations
- **new_str** (string) - Optional - Replacement string for str_replace operations
```

--------------------------------

### NameSearch

Source: https://docs.macro.com/AI/mcp/tools/name-search

Search for entities by name and type using the NameSearch tool.

```APIDOC
## NameSearch

### Description
Searches for items based on a specified name and a list of entity types.

### Parameters
- **entityTypes** (array) - Required - Which types of items to search. Leave empty to search all types. Examples: ['documents'], ['emails', 'documents'], ['channels']
- **name** (string) - Required - The name or title to search for. For emails, this is the subject line. For channels, this can be the channel name or participant names.
```

--------------------------------

### GetEntityProperties

Source: https://docs.macro.com/AI/mcp/tools/get-entity-properties

Retrieves the properties of a specified entity.

```APIDOC
## GetEntityProperties

### Description
Retrieves the properties for a specific entity based on its ID and type.

### Parameters
- **entity_id** (string) - Required - The ID of the entity to get properties for.
- **entity_type** (string) - Required - The type of entity.
```

--------------------------------

### GetThread

Source: https://docs.macro.com/AI/mcp/tools/get-thread

Retrieves messages from a specific email thread.

```APIDOC
## GetThread

### Description
Retrieves a specified number of messages from an email thread using the thread ID.

### Parameters
#### Required Parameters
- **threadId** (string) - Required - The ID of the email thread to retrieve.
- **limit** (integer) - Required - Maximum number of messages to return (default 10).
```

--------------------------------

### ReadContent

Source: https://docs.macro.com/AI/mcp/tools/read-content

Retrieves the content of a document based on the provided document ID.

```APIDOC
## ReadContent

### Description
Retrieves the content of a specific document from the Macro system.

### Parameters
- **documentId** (string) - Required - The id of the document you want to retrieve content for.
```

--------------------------------

### ContentSearch

Source: https://docs.macro.com/AI/mcp/tools/content-search

The ContentSearch tool enables searching for specific text content within documents, emails, and messages. Users can filter the search by specifying entity types.

```APIDOC
## ContentSearch

### Description
Searches for text content within the body of documents, emails, and messages.

### Parameters
- **entityTypes** (array) - Required - Which types of items to search. Leave empty to search all types. Examples: ['documents'], ['emails', 'documents'], ['channels']
- **query** (string) - Required - The text content to search for.
```

--------------------------------

### UpdateThreadLabels

Source: https://docs.macro.com/AI/mcp/tools/update-thread-labels

Updates the labels associated with a specific email thread.

```APIDOC
## UpdateThreadLabels

### Description
Updates the labels associated with a specific email thread by adding or removing a label.

### Parameters
- **add** (boolean) - Required - Whether to add (true) or remove (false) the label.
- **label_id** (string) - Required - The ID of the label to add or remove. Use ListLabels to get valid label IDs.
- **thread_id** (string) - Required - The ID of the email thread to modify.
```

--------------------------------

### ReadMetadata

Source: https://docs.macro.com/AI/mcp/tools/read-metadata

Retrieves metadata for a specified document ID.

```APIDOC
## ReadMetadata

### Description
Retrieves the metadata associated with a specific document using its unique identifier.

### Parameters
- **documentId** (string) - Required - The id of the document you want to retrieve metadata for.
```

--------------------------------

### SetEntityProperty

Source: https://docs.macro.com/AI/mcp/tools/set-entity-property

Updates a specific property of an entity. This tool supports various property types including boolean, date, entity references, links, numbers, and select options.

```APIDOC
## SetEntityProperty

### Description
Updates a property value for a specified entity.

### Parameters
- **entity_id** (string) - Required - The ID of the entity to update.
- **entity_type** (string) - Required - The type of entity.
- **property_definition_id** (string) - Required - The property definition ID.
- **boolean_value** (boolean) - Required - For boolean properties.
- **date_value** (string) - Required - For date properties (ISO 8601 date-time).
- **entity_ref** (object) - Required - For single entity reference properties.
- **entity_refs** (array) - Required - For multi entity reference properties.
- **link_url** (string) - Required - For single link properties.
- **link_urls** (array) - Required - For multi link properties.
- **number_value** (number) - Required - For number properties.
- **option_id** (string) - Required - For single-select properties (option UUID).
- **option_ids** (array) - Required - For multi-select properties (option UUIDs).
- **string_value** (string) - Required - For string properties.
```
Tokens:
Raw