# Contacts+

```json
{
  "name": "Contacts+",
  "slug": "contacts_plus",
  "url": "https://composio.dev/toolkits/contacts_plus",
  "markdown_url": "https://composio.dev/toolkits/contacts_plus.md",
  "logo_url": "https://logos.composio.dev/api/contacts_plus",
  "categories": [
    "productivity & project management",
    "crm"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-08-20T15:34:57.608Z"
}
```

![Contacts+ logo](https://logos.composio.dev/api/contacts_plus)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Contacts+ MCP or direct API to search contacts, read account data, manage contact records, and organize tags through natural language.

## Summary

Contacts+ is a contact management service for personal account, contact, and tag data.
It helps keep address books organized, searchable, and easier to maintain across workflows.

## Categories

- productivity & project management
- crm

## Toolkit Details

- Tools: 13

## Images

- Logo: https://logos.composio.dev/api/contacts_plus

## Authentication

- **Oauth2**
  - Type: `oauth2`
  - Description: Oauth2 authentication for Contacts+.
  - Setup:
    - Configure Oauth2 credentials for Contacts+.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Find contacts tagged as investors
- List customers missing phone numbers
- Show recently updated contact records

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `CONTACTS_PLUS_CREATE_CONTACT` | Create Contact | Create a personal contact with structured profile data in the connected Contacts+ address book. |
| `CONTACTS_PLUS_CREATE_TAG` | Create Tag | Create a personal Contacts+ tag, or return the existing tag when that name already exists. Before updating or deleting it, call GET_TAGS with the returned tag ID to obtain the canonical etag. |
| `CONTACTS_PLUS_DELETE_CONTACT` | Delete Contact | Delete one personal contact using its current etag for concurrency protection. Refresh the etag after any update or contact-tag change before deleting. |
| `CONTACTS_PLUS_DELETE_TAG` | Delete Tag | Delete one personal tag using its current canonical etag. Call GET_TAGS after any preceding tag write to obtain the canonical etag before deleting. |
| `CONTACTS_PLUS_GET_ACCOUNT` | Get Account | Return profile details for the authenticated Contacts+ personal account. |
| `CONTACTS_PLUS_GET_CONTACTS` | Get Contacts | Fetch current full records for one or more personal contacts by ID, including etags needed for safe updates and deletes. |
| `CONTACTS_PLUS_GET_TAGS` | Get Tags | Fetch current records for one or more personal tags by ID, including canonical etags needed for safe updates and deletes. |
| `CONTACTS_PLUS_LIST_CONTACTS` | List Contacts | Return one cursor-controlled page of personal contacts from the connected Contacts+ address book. |
| `CONTACTS_PLUS_LIST_TAGS` | List Tags | Return one cursor-controlled page of personal Contacts+ tags. |
| `CONTACTS_PLUS_SEARCH_CONTACTS` | Search Contacts | Search personal contacts by full text or Contacts+ advanced query syntax, optionally restricted to tag IDs. Returns one cursor-controlled page. Search results may omit etags, so fetch selected records with GET_CONTACTS before mutation. |
| `CONTACTS_PLUS_UPDATE_CONTACT` | Update Contact | Replace the desired data for a personal contact using its current etag and strict optimistic concurrency by default. Send all fields that must remain. |
| `CONTACTS_PLUS_UPDATE_CONTACT_TAGS` | Update Contact Tags | Add and/or remove personal tags across one or more personal contacts in a single operation. Each affected contact receives a new etag. |
| `CONTACTS_PLUS_UPDATE_TAG` | Update Tag | Rename a personal tag using its current canonical etag from GET_TAGS. Read the tag back after updating because write-response etags may not be canonical for the next protected mutation. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Contacts+ Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Contacts+ actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Find contacts tagged as investors in Contacts+'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Find contacts tagged as investors in Contacts+'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK for Python or TypeScript
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Initialize Client and Create Tool Router Session

Import and initialize the Composio client, then create a Tool Router session for Contacts+
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent (Anthropic Claude or Mastra)
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Contacts+ tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('List all Contacts+ contacts tagged customers')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'List all Contacts+ contacts tagged customers'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Contacts+ Integration

- Supports both Contacts+ MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable contact lookup and tag actions
- Rich coverage for reading, writing, and querying your Contacts+ data

### 2. Managed Auth

- Built-in OAuth handling with automatic token refresh and rotation
- Central place to manage, scope, and revoke Contacts+ access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know which Contacts+ action ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Contacts+
- Scoped, least privilege access to Contacts+ contact and tag resources
- Full audit trail of agent actions to support review and compliance

## Use Contacts+ with any AI Agent Framework

Choose a framework you want to connect Contacts+ with:

None listed.

## Related Toolkits

- [Google Sheets](https://composio.dev/toolkits/googlesheets) - Google Sheets is a cloud-based spreadsheet tool for real-time collaboration and data analysis. It lets teams work together from anywhere, updating information instantly.
- [Notion](https://composio.dev/toolkits/notion) - Notion is a collaborative workspace for notes, docs, wikis, and tasks. It streamlines team knowledge, project tracking, and workflow customization in one place.
- [Airtable](https://composio.dev/toolkits/airtable) - Airtable combines the flexibility of spreadsheets with the power of a database for easy project and data management. Teams use Airtable to organize, track, and collaborate with custom views and automations.
- [HubSpot](https://composio.dev/toolkits/hubspot) - HubSpot is an all-in-one marketing, sales, and customer service platform. It lets teams nurture leads, automate outreach, and track every customer interaction in one place.
- [Asana](https://composio.dev/toolkits/asana) - Asana is a collaborative work management platform for teams to organize and track projects. It streamlines teamwork, boosts productivity, and keeps everyone aligned on goals.
- [Pipedrive](https://composio.dev/toolkits/pipedrive) - Pipedrive is a sales management platform offering pipeline visualization, lead tracking, and workflow automation. It helps sales teams keep deals moving forward efficiently and never miss a follow-up.
- [Google Tasks](https://composio.dev/toolkits/googletasks) - Google Tasks is a to-do list and task management tool integrated into Gmail and Google Calendar. It helps you organize, track, and complete tasks across your Google ecosystem.
- [Linear](https://composio.dev/toolkits/linear) - Linear is a modern issue tracking and project planning tool for fast-moving teams. It helps streamline workflows, organize projects, and boost productivity.
- [Salesforce](https://composio.dev/toolkits/salesforce) - Salesforce is a leading CRM platform that helps businesses manage sales, service, and marketing. It centralizes customer data, enabling teams to drive growth and build strong relationships.
- [Jira](https://composio.dev/toolkits/jira) - Jira is Atlassian’s platform for bug tracking, issue tracking, and agile project management. It helps teams organize work, prioritize tasks, and deliver projects efficiently.
- [Clickup](https://composio.dev/toolkits/clickup) - ClickUp is an all-in-one productivity platform for managing tasks, docs, goals, and team collaboration. It streamlines project workflows so teams can work smarter and stay organized in one place.
- [Monday](https://composio.dev/toolkits/monday) - Monday.com is a customizable work management platform for project planning and collaboration. It helps teams organize tasks, automate workflows, and track progress in real time.
- [Apollo](https://composio.dev/toolkits/apollo) - Apollo is a CRM and lead generation platform that helps businesses discover contacts and manage sales pipelines. Use it to streamline customer outreach and track your deals from one place.
- [Attio](https://composio.dev/toolkits/attio) - Attio is a customizable CRM and workspace for managing your team's relationships and workflows. It helps teams organize contacts, automate tasks, and collaborate more efficiently.
- [Acculynx](https://composio.dev/toolkits/acculynx) - AccuLynx is a cloud-based roofing business management software for contractors. It streamlines project tracking, lead management, and document sharing.
- [Addressfinder](https://composio.dev/toolkits/addressfinder) - Addressfinder is a data quality platform for verifying addresses, emails, and phone numbers. It helps you ensure accurate customer and contact data every time.
- [Affinity](https://composio.dev/toolkits/affinity) - Affinity is a relationship intelligence CRM that helps private capital investors find, manage, and close more deals. It streamlines deal flow and surfaces key connections to help you win opportunities.
- [Agencyzoom](https://composio.dev/toolkits/agencyzoom) - AgencyZoom is a sales and performance platform built for P&C insurance agencies. It helps agents boost sales, retain clients, and analyze producer results in one place.
- [Agiled](https://composio.dev/toolkits/agiled) - Agiled is an all-in-one business management platform for CRM, projects, and finance. It helps you streamline workflows, consolidate client data, and manage business processes in one place.
- [ApptiveGrid](https://composio.dev/toolkits/apptivegrid) - ApptiveGrid is a collaborative no-code database and app platform for spaces, grids, forms, and structured records. It helps teams organize operational data, collect inputs, and build lightweight business apps without custom backend work.

## Frequently Asked Questions

### Do I need my own developer credentials to use Contacts+ with Composio?

Yes, Contacts+ requires you to configure your own OAuth credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)