manage-contact
Manage your Outlook contacts: list, search, create, update, or permanently delete entries in your personal address book.
Instructions
Full CRUD over the signed-in user's personal Outlook contacts (destructive: covers delete action). action=list (default) returns contacts with pagination via skip/count (default 50). action=search returns contacts matching query against name/email (default 25). action=get returns full contact detail by id. action=create adds a new contact and returns its id. action=update patches the given fields by id (only fields passed are changed). action=delete permanently removes the contact by id. Use outputVerbosity (minimal/standard/full) on list/search to control field count. Prefer search-people for cross-source relevance ranking (contacts + directory + recent comms) — this tool only searches your personal contact store.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Contact ID (action=get/update/delete, required) | |
| skip | No | Pagination offset for action=list (default: 0). Use the value suggested by the previous page response. | |
| count | No | Number of results (action=list default: 50, action=search default: 25) | |
| No | Primary email address (action=create/update) | ||
| notes | No | Personal notes (action=create/update) | |
| query | No | Search query for name or email (action=search, required) | |
| action | No | Action to perform (default: list) | |
| emails | No | Multiple email addresses (action=create/update). First entry is primary. | |
| folder | No | Contact folder ID (action=list) | |
| jobTitle | No | Job title (action=create/update) | |
| lastName | No | Surname (action=create/update). Maps to Graph `surname`. | |
| firstName | No | Given name (action=create/update). Maps to Graph `givenName`. If displayName not provided, will be combined with lastName. | |
| companyName | No | Company name (action=create/update) | |
| displayName | No | Full name (action=create/update) | |
| mobilePhone | No | Mobile phone number (action=create/update) | |
| outputVerbosity | No | Output detail level (action=list/search, default: standard) |