Nextdoor MCP tools

MCP tool nextdoor_get_business_page

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

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

Example response

{
  "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
}

MCP tool nextdoor_list_posts

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

tools/call

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

Example response

{
  "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
}

MCP tool nextdoor_get_post

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

Parameters

tools/call

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

Example response

{
  "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
}

MCP tool nextdoor_list_comments

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

Parameters

tools/call

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

Example response

{
  "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
}

MCP tool nextdoor_list_recommendations

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

Parameters

tools/call

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

Example response

{
  "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
}

MCP tool nextdoor_get_page_share_link

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

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

Example response

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

MCP tool nextdoor_list_conversations

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

Parameters

tools/call

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

Example response

{
  "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
}

MCP tool nextdoor_get_conversation

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

Parameters

tools/call

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

Example response

{
  "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
}

MCP tool nextdoor_create_post

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

tools/call

{
  "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

{
  "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
}

MCP tool nextdoor_reply_to_comment

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

tools/call

{
  "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

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

MCP tool nextdoor_reply_to_recommendation

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

tools/call

{
  "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

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

MCP tool nextdoor_send_message

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

tools/call

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

Example response

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

MCP tool nextdoor_delete_post

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

tools/call

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

Example response

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