# Nextdoor MCP tools

> Every Nextdoor MCP tool on the Cotlet server: tool names, input schemas, a tools/call example and an example result for each tool.

Source: https://cotlet.dev/docs/mcp/nextdoor

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

13 tools for Nextdoor on the Cotlet MCP server. Your agent picks them from tools/list.

- MCP server: `https://cotlet.dev/mcp/v1`
- Connects with: Your own Nextdoor account with a claimed Business Page (owner, employee or authorized representative)
- Integration page: https://cotlet.dev/integrations/nextdoor-api-mcp-server

## Endpoints

| Endpoint | Access | Description |
|---|---|---|
| `nextdoor_get_business_page` | read | Your page: name, category, contact details, neighborhoods, recommendation and Fave counts. |
| `nextdoor_list_posts` | read | Business posts from your Business Page, newest first. |
| `nextdoor_get_post` | read | One post: title, text, audience, reactions and comment count. |
| `nextdoor_list_comments` | read | Comments on one of your posts, with author, neighborhood, text and whether you replied. |
| `nextdoor_list_recommendations` | read | Recommendations from the What neighbors say section, with author, neighborhood, text, date and your reply. |
| `nextdoor_get_page_share_link` | read | The link to your Business Page from the Share menu, to send to customers who should leave a recommendation. |
| `nextdoor_list_conversations` | read | Messages neighbors sent to your Business Page, with the last message and who wrote it. |
| `nextdoor_get_conversation` | read | Full message thread with one neighbor. |
| `nextdoor_create_post` | write | Publish a business post to the neighborhoods you choose. |
| `nextdoor_reply_to_comment` | write | Reply as your business under a comment on one of your posts. |
| `nextdoor_reply_to_recommendation` | write | Public reply from your business to a neighbor's recommendation. |
| `nextdoor_send_message` | write | Reply to a neighbor inside an existing Business Page conversation. |
| `nextdoor_delete_post` | write | Remove one of your business posts from Nextdoor. |

## Get Business Page

MCP tool: `nextdoor_get_business_page`

Access: read.

Returns the page the signed-in account manages. Use the neighborhoods it lists as the audience for create_post. The call fails if the account has no claimed Business Page.

### Parameters

No parameters.

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nextdoor_get_business_page",
    "arguments": {}
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "page_id": "pg_2204",
    "name": "Clearwater Gutter Care",
    "category": "Gutter cleaning",
    "phone": "+1 555 0142",
    "neighborhoods": [
      "Maple Hill",
      "Oak Park",
      "Riverside"
    ],
    "recommendations": 41,
    "faves": 118
  },
  "isError": false
}
```

## List posts

MCP tool: `nextdoor_list_posts`

Access: read.

Returns each post with title, text, audience, reactions and comment count. Nextdoor's Post Insights are not available for business posts, so there are no view counts. Use the cursor to read older posts.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `limit` | integer | no | Number of posts per call. Default: 20. |
| `cursor` | string | no | Next page cursor from the previous call. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nextdoor_list_posts",
    "arguments": {}
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "posts": [
      {
        "post_id": "bp_8812046",
        "title": "Open house this Saturday",
        "reactions": 12,
        "comments": 3,
        "created_at": "2026-10-08T09:30:00Z"
      },
      {
        "post_id": "bp_8790311",
        "title": "Fall gutter checks",
        "reactions": 7,
        "comments": 1,
        "created_at": "2026-10-01T08:00:00Z"
      }
    ],
    "next_cursor": null
  },
  "isError": false
}
```

## Get post

MCP tool: `nextdoor_get_post`

Access: read.

Returns the full text and the audience (distance or neighborhoods) the post was published to. Comments are read with list_comments.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `post_id` | string | yes | Post ID from list_posts. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nextdoor_get_post",
    "arguments": {
      "post_id": "post_8c41d2"
    }
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "post_id": "bp_8812046",
    "title": "Open house this Saturday",
    "body": "Drop by 10:00 to 14:00 for free coffee and a look at the new workshop.",
    "neighborhoods": [
      "Maple Hill",
      "Oak Park"
    ],
    "reactions": 12,
    "comments": 3
  },
  "isError": false
}
```

## List comments

MCP tool: `nextdoor_list_comments`

Access: read.

Returns comments oldest first, so your agent reads the discussion in order. Each comment has the ID that reply_to_comment needs.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `post_id` | string | yes | Post ID from list_posts. |
| `unanswered_only` | boolean | no | Skip comments you already replied to. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nextdoor_list_comments",
    "arguments": {
      "post_id": "post_8c41d2"
    }
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "comments": [
      {
        "comment_id": "cm_77120",
        "author": "Priya S.",
        "neighborhood": "Maple Hill",
        "body": "Do you service Maple Hill?",
        "replied": false
      }
    ]
  },
  "isError": false
}
```

## List recommendations

MCP tool: `nextdoor_list_recommendations`

Access: read.

Returns newest first. Each recommendation has the ID that reply_to_recommendation needs, and your existing reply if you wrote one.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `since` | date | no | Only recommendations on or after this date. |
| `unanswered_only` | boolean | no | Skip recommendations you already replied to. |
| `limit` | integer | no | Number of recommendations per call. Default: 50. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nextdoor_list_recommendations",
    "arguments": {}
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "recommendations": [
      {
        "recommendation_id": "rec_30418",
        "author": "Dana K.",
        "neighborhood": "Oak Park",
        "body": "Cleaned our gutters in one morning and left the yard spotless.",
        "date": "2026-10-06",
        "reply": null
      }
    ]
  },
  "isError": false
}
```

## Get page share link

MCP tool: `nextdoor_get_page_share_link`

Access: read.

Returns the page link. A neighbor who opens it can recommend your business on the page; Nextdoor asks them to sign in or create a free account first.

### Parameters

No parameters.

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nextdoor_get_page_share_link",
    "arguments": {}
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "url": "https://nextdoor.com/pages/clearwater-gutter-care"
  },
  "isError": false
}
```

## List conversations

MCP tool: `nextdoor_list_conversations`

Access: read.

Returns the most recent threads first. Neighbors start these conversations; a business cannot start one.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `unanswered_only` | boolean | no | Only threads where the last message is not yours. |
| `limit` | integer | no | Number of threads per call. Default: 20. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nextdoor_list_conversations",
    "arguments": {}
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "conversations": [
      {
        "conversation_id": "conv_5530",
        "neighbor": "Priya S.",
        "last_message": "Can you come Thursday morning?",
        "last_from": "neighbor",
        "updated_at": "2026-10-10T16:12:00Z"
      }
    ]
  },
  "isError": false
}
```

## Get conversation

MCP tool: `nextdoor_get_conversation`

Access: read.

Returns the messages oldest first. Reading a thread does not send anything.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `conversation_id` | string | yes | Conversation ID from list_conversations. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nextdoor_get_conversation",
    "arguments": {
      "conversation_id": "conversation_8c41d2"
    }
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "conversation_id": "conv_5530",
    "neighbor": "Priya S.",
    "messages": [
      {
        "from": "neighbor",
        "body": "Hi, do you do gutter guards?",
        "sent_at": "2026-10-10T15:58:00Z"
      },
      {
        "from": "business",
        "body": "Yes, we do. What is the address?",
        "sent_at": "2026-10-10T16:05:00Z"
      },
      {
        "from": "neighbor",
        "body": "Can you come Thursday morning?",
        "sent_at": "2026-10-10T16:12:00Z"
      }
    ]
  },
  "isError": false
}
```

## Create post

MCP tool: `nextdoor_create_post`

Access: write. Confirm: waits for the user's OK before it runs.

Publishes a post with a title and a description. Nextdoor's help center says business posts have no fixed radius and reach neighbors through engagement and Faves; radius and neighborhoods apply only where the post form still offers audience settings. The call fails for accounts Nextdoor still asks to verify business documents. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `title` | string | yes | Post title. |
| `body` | string | yes | Post description. |
| `radius` | integer | no | Reach neighborhoods within this distance of your business, as in the post audience settings. |
| `neighborhoods` | string[] | no | Neighborhood names to add or remove, from get_business_page. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nextdoor_create_post",
    "arguments": {
      "title": "Open house this Saturday",
      "body": "Drop by 10:00 to 14:00 for free coffee and a look at the new workshop.",
      "radius": 3
    }
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "post_id": "bp_8812046",
    "status": "published",
    "neighborhoods": 14,
    "url": "https://nextdoor.com/p/yourname-open-house"
  },
  "isError": false
}
```

## Reply to comment

MCP tool: `nextdoor_reply_to_comment`

Access: write. Confirm: waits for the user's OK before it runs.

The reply is public and appears under your business name. Only the author or the page administrator can edit or delete it later. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `comment_id` | string | yes | Comment ID from list_comments. |
| `body` | string | yes | Reply text. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nextdoor_reply_to_comment",
    "arguments": {
      "comment_id": "cm_77120",
      "body": "Yes, we cover Maple Hill. Message the page with your street and we will suggest a time."
    }
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "reply_id": "cm_77135",
    "comment_id": "cm_77120",
    "status": "published"
  },
  "isError": false
}
```

## Reply to recommendation

MCP tool: `nextdoor_reply_to_recommendation`

Access: write. Confirm: waits for the user's OK before it runs.

The reply is public and appears under the recommendation as your business, not your personal profile. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `recommendation_id` | string | yes | Recommendation ID from list_recommendations. |
| `body` | string | yes | Reply text. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nextdoor_reply_to_recommendation",
    "arguments": {
      "recommendation_id": "rec_30418",
      "body": "Thank you, Dana! Glad the gutters are running clear again."
    }
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "reply_id": "rr_9120",
    "recommendation_id": "rec_30418",
    "status": "published"
  },
  "isError": false
}
```

## Send message

MCP tool: `nextdoor_send_message`

Access: write. Confirm: waits for the user's OK before it runs.

Works only in a conversation the neighbor started. A business cannot message a neighbor first, and Nextdoor bans unsolicited promotional messages. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `conversation_id` | string | yes | Conversation ID from list_conversations. |
| `body` | string | yes | Message text. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nextdoor_send_message",
    "arguments": {
      "conversation_id": "conversation_8c41d2",
      "body": "body"
    }
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "message_id": "msg_88410",
    "conversation_id": "conv_5530",
    "status": "sent"
  },
  "isError": false
}
```

## Delete post

MCP tool: `nextdoor_delete_post`

Access: write. Confirm: waits for the user's OK before it runs.

Removes the post from the newsfeed. Only the author or the page administrator can delete a post. A deleted post cannot be restored with one call. By default you confirm each call; you can switch that off for this tool.

### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `post_id` | string | yes | Post ID from list_posts. |

### tools/call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nextdoor_delete_post",
    "arguments": {
      "post_id": "post_8c41d2"
    }
  }
}
```

### Example response

```json
{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "post_id": "bp_8790311",
    "status": "deleted"
  },
  "isError": false
}
```