How-To Guides
Last updated: 6 March 2026
How to Manage Your Contacts
Create, view, update, and delete contact records in your Outlook contacts book.
Add, view, update, and delete entries in your Outlook personal contacts book.
View a Contact’s Full Details
tool: manage-contact
params:
action: "get"
id: "contact-id..."
Create a New Contact
“Add a contact for Jane Smith at jane@company.com”
tool: manage-contact
params:
action: "create"
displayName: "Jane Smith"
email: "jane@company.com"
With additional details:
tool: manage-contact
params:
action: "create"
displayName: "Jane Smith"
email: "jane@company.com"
mobilePhone: "+61 400 000 000"
companyName: "Acme Corp"
jobTitle: "Product Manager"
notes: "Met at the Melbourne conference"
If displayName contains a space, it’s automatically split into first and last name.
Update an Existing Contact
“Update Jane’s email to jane.smith@newcompany.com”
tool: manage-contact
params:
action: "update"
id: "contact-id..."
email: "jane.smith@newcompany.com"
Only the fields you specify are updated — existing fields are preserved.
Delete a Contact
tool: manage-contact
params:
action: "delete"
id: "contact-id..."
Parameter Reference
| Parameter | What it does | Used with |
|---|---|---|
action | list, search, get, create, update, delete | All |
id | Contact ID | get, update, delete |
displayName | Full name | create, update |
email | Primary email address | create, update |
mobilePhone | Mobile phone number | create, update |
companyName | Company name | create, update |
jobTitle | Job title | create, update |
notes | Personal notes | create, update |
query | Search text | search |
count | Number of results | list, search |
Tips
- At least
displayNameoremailis required when creating a contact - Use
search-peoplefor broader searches (directory + recent contacts) — see Find Contacts and People - Contacts sync across Outlook desktop, web, and mobile
Related
- Find Contacts and People — search for people across all sources
- Tools Reference — manage-contact
Was this helpful?
Thanks for your feedback!
Related Articles
ReferenceTools Reference - Outlook AssistantQuick reference for all 20 consolidated MCP tools across 9 modules. Each tool includes MCP safety annotations (readOnlyHint, destructiveHint, idempotentHint).GuidesHow to Use Outlook Assistant in AI AgentsReference guide for AI agents using Outlook Assistant — tool selection, parameter patterns, output formats, and safety considerations.GuidesHow to Monitor Your Inbox with Delta SyncUse delta sync for incremental inbox monitoring — track new, modified, and deleted emails with deltaToken.